TAA Tools
WRKSBSD2        WORK SUBSYSTEM DESCRIPTION 2           TAAJODH

Work Subsystem  Description  2 provides  an 'easier  to use'  interface
than  that   provided  by  the   system  for  working   with  Subsystem
Descriptions.   In  addition to  the function  provided by  the system,
the initial  display describes  whether a subsystem  is active.   If  a
change is required,  each of the sub options  (such as Routing Entries)
provides  a Work  display which allows  Add, Copy,  Change, Remove, and
Display functions.   When  Change  or Copy  is requested,  the  current
values appear on the command prompt.

An option on  the command allows you  to go directly to  a work display
if a specific subsystem is named.

You must  have *CHANGE authority to the  subsystem to make any changes.

A typical command would be:

             WRKSBSD2      SBSD(*ALL)

A display would  appear that is  similar to WRKSBSD  with the  addition
of a field that indicates if the subsystem is active.

Options exist (as  on WRKSBSD) to  display, create (using  F6), delete,
start, end, etc.

If the  Change option is requested, a display  similar to that provided
by  DSPSBSD is shown  with individual options  such as Routing Entries,
Pre-start jobs, etc.   Each option selected would display a  subfile of
the  current  information  and  allow  the Change,  Copy,  Remove,  and
Display options.

The  Change  and Copy  options access  the  attributes of  the selected
entry and prompt with the appropriate  command.  F6 may be used for  an
ADDxxx prompt.

Another typical command would be:

             WRKSBSD2      SBSD(ABC) TYPE(*RTGE)

A display  of the routing  entries for the  ABC subsystem  would appear
and normal maintenance options could be used.

ADDDEVE and ADDRMTLOCE commands
-------------------------------

Two  commands are also  provided to  perform the separate  functions of
the system ADDCMNE  command.   ADDCMNE allows  either a DEV  name or  a
RMTLOCNAME  to  be  entered.    Prompting   for  this  function  during
WRKSBSD2 provides an awkward looking interface.

Thus  the  two  front   end  commands  were  added  so  that  only  the
appropriate parameter is provided on each.

WRKSBSD2 escape messages you can monitor for
--------------------------------------------

None.  Escape messages from based on functions will be re-sent.

WRKSBSD2 Command parameters                           *CMD
---------------------------

   SBSD          The  qualified  name of  the Subsystem  Description to
                 be worked with.   An individual name, a generic  name,
                 or the special value *ALL may be entered.

                 The  library  value  defaults  to  *LIBL.    *USRLIBL,
                 *CURLIB, *ALL, or *ALLUSR may be entered.

   TYPE          The  detail type of display to  be used instead of the
                 general menu.

                 *NONE is the default which  must be used if *ALL or  a
                 generic name is used for the SBSD parameter.

                 The  following special  names  may be  used to  branch
                 directly  to  a display  of  the specific  parts  of a
                 subsystem:

                    - *OPER      Operational attributes
                    - *POOL      Pool definitions
                    - *AJE       Autostart job entries
                    - *NAMWSE    Workstation name entries
                    - *TYPWSE    Workstation type entries
                    - *JOBQE     Job queue queue entries
                    - *RTGE      Routing entries
                    - *DEVCMNE   Device entries
                    - *RMTCMNE   Remote location name entries
                    - *PJE       Prestart job entries

ADDDEVE Command parameters                            *CMD
--------------------------

   SBSD          The qualified  name of  the Subsystem  Description  to
                 be added to.

                 The library value  defaults to *LIBL.  *CURLIB  may be
                 entered.

   DEV           The name  of the device to be added.   A generic name,
                 *ALL,  or the  specific values  *APPC, *ASYNC, *BSCEL,
                 *FINANCE, *INTRA,  *RETAIL, or  *SNUF may be  entered.

   JOBD          The  qualified  name  of  the Job  Description  to  be
                 used.   *USRPRF  is the  default for the  user profile
                 that made

                 *SBSD may  be entered  to mean  the same  name as  the
                 subsystem.

                 The  library value  may be  a library  name, *LIBL  or
                 *CURLIB.

   DFTUSR        The  user profile  assigned to the  job.   The default
                 is *NONE meaning no user  profile is specified as  the
                 default.

                 *SYS may be  specified meaning all user  program start
                 requests  will  be  treated  as  *NONE.    All  system
                 requests   will   run  under   a   predetermined  user
                 profile.

   MODE          The mode name of  the communications device.  *ANY  is
                 the default meaning any available mode.

   MAXACT        The maximum  number of  jobs that may  be run  for the
                 device  entry.  A  value 0-1000 may be  entered or the
                 special value *NOMAX.

ADDRMTLOCE Command parameters                         *CMD
-----------------------------

   SBSD          The qualified  name of  the Subsystem  Description  to
                 be added to.

                 The library value  defaults to *LIBL.   *CURLIB may be
                 entered.

   RMTLOCNAME    The  name of the  remote location as  specified in the
                 Create Device Description command.

   JOBD          The qualified  name  of  the  Job  Description  to  be
                 used.   *USRPRF is  the default  for the user  profile
                 that made

                 *SBSD  may be  entered to  mean the  same name  as the
                 subsystem.

                 The  library  value may  be a  library name,  *LIBL or
                 *CURLIB.

   DFTUSR        The user  profile assigned  to the job.   The  default
                 is *NONE  meaning no user profile is  specified as the
                 default.

                 *SYS  may be specified meaning  all user program start
                 requests  will  be  treated  as  *NONE.    All  system
                 requests   will  run   under   a  predetermined   user
                 profile.

   MODE          The  mode name  of the remote  location device.   *ANY
                 is the default meaning any available mode.

   MAXACT        The maximum number  of jobs  that may be  run for  the
                 device entry.   A value 0-1000  may be entered  or the
                 special value *NOMAX.

Restrictions
------------

You  must have  *CHANGE authority to  the subsystem  to use  the Change
option for a subsystem.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKGENERC       Check generic
     CHKOBJ3         Check object 3
     CVTSBSD         Convert subsystem description
     DSPERRMSG       Display error message
     EDTVAR          Edit variable
     FILEFDBCK       File feedback
     RTVSBSD         Retrieve subsystem description
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     TAAEXC          TAA Execute

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   WRKSBSD2      *CMD                   TAAJODH       QATTCMD
   ADDDEVE       *CMD                   TAAJODH2      QATTCMD
   ADDRMTLOCE    *CMD                   TAAJODH3      QATTCMD
   TAAJODHC      *PGM       CLP         TAAJODHC      QATTCL
   TAAJODHC2     *PGM       CLP         TAAJODHC2     QATTCL
   TAAJODHC3     *PGM       CLP         TAAJODHC3     QATTCL
   TAAJODHC11    *PGM       CLP         TAAJODHC11    QATTCL
   TAAJODHC12    *PGM       CLP         TAAJODHC12    QATTCL
   TAAJODHC13    *PGM       CLP         TAAJODHC13    QATTCL
   TAAJODHC14    *PGM       CLP         TAAJODHC14    QATTCL
   TAAJODHC15    *PGM       CLP         TAAJODHC15    QATTCL
   TAAJODHC16    *PGM       CLP         TAAJODHC16    QATTCL
   TAAJODHC17    *PGM       CLP         TAAJODHC17    QATTCL
   TAAJODHC18    *PGM       CLP         TAAJODHC18    QATTCL
   TAAJODHC19    *PGM       CLP         TAAJODHC19    QATTCL
   TAAJODHC20    *PGM       CLP         TAAJODHC20    QATTCL
   TAAJODHC26    *PGM       CLP         TAAJODHC26    QATTCL
   TAAJODHC30    *PGM       CLP         TAAJODHC30    QATTCL
   TAAJODHC31    *PGM       CLP         TAAJODHC31    QATTCL
   TAAJODHC55    *PGM       CLP         TAAJODHC55    QATTCL
   TAAJODHR      *PGM       RPG         TAAJODHR      QATTRPG
   TAAJODHR10    *PGM       RPG         TAAJODHR10    QATTRPG
   TAAJODHR12    *PGM       RPG         TAAJODHR12    QATTRPG
   TAAJODHR13    *PGM       RPG         TAAJODHR13    QATTRPG
   TAAJODHR14    *PGM       RPG         TAAJODHR14    QATTRPG
   TAAJODHR15    *PGM       RPG         TAAJODHR15    QATTRPG
   TAAJODHR16    *PGM       RPG         TAAJODHR16    QATTRPG
   TAAJODHR17    *PGM       RPG         TAAJODHR17    QATTRPG
   TAAJODHR18    *PGM       RPG         TAAJODHR18    QATTRPG
   TAAJODHR19    *PGM       RPG         TAAJODHR19    QATTRPG
   TAAJODHR20    *PGM       RPG         TAAJODHR20    QATTRPG
   TAAJODHD      *FILE      DSPF        TAAJODHD      QATTDDS
   TAAJODHE      *FILE      DSPF        TAAJODHE      QATTDDS
   TAAJODHF      *FILE      DSPF        TAAJODHF      QATTDDS
   TAAJODHG      *FILE      DSPF        TAAJODHG      QATTDDS
   TAAJODHH      *FILE      DSPF        TAAJODHH      QATTDDS
   TAAJODHI      *FILE      DSPF        TAAJODHI      QATTDDS
   TAAJODHJ      *FILE      DSPF        TAAJODHJ      QATTDDS
   TAAJODHK      *FILE      DSPF        TAAJODHK      QATTDDS
   TAAJODHL      *FILE      DSPF        TAAJODHL      QATTDDS
   TAAJODHM      *FILE      DSPF        TAAJODHM      QATTDDS
   TAAJODHN      *FILE      DSPF        TAAJODHN      QATTDDS
   TAAJODHO      *FILE      DSPF        TAAJODHO      QATTDDS

Structure
---------

WRKSBSD2    Cmd
   TAAJODHC   CL pgm
     TAAJODHR   RPG Pgm
       TAAJODHO   Display file
         TAAJODHC30  Get status (also called by other programs)
         TAAJODHC31  Processes options (Change calls TAAJODHR10)

     TAAJODHR10 is the main program to display the menu of sbs options
       TAAJODHD   Display file

       TAAJODHC11 CL pgm  Operational attributes
         TAAJODHE   Display file

  Each sub function calls TAAJODHC55 - Does CVTSBSD to outfile

  Pools assigned
       TAAJODHR12  RPG Pgm
         TAASYSVY   CVTSBSD SBSPOOL PF
         TAAJODHF   Display file
         TAAJODHC12   Pool commands

  Auto start jobs
       TAAJODHR13  RPG Pgm
         TAASYSVT   CVTSBSD SBSAUTSTR PF
         TAAJODHG   Display file
         TAAJODHC13   Auto start commands

  Workstation name
       TAAJODHR14  RPG Pgm
         TAASYSVV   CVTSBSD SBSSTNNAM PF
         TAAJODHH   Display file
         TAAJODHC14   Workstation name commands

  Workstation type
       TAAJODHR15  RPG Pgm
         TAASYSVW   CVTSBSD SBSSTNTYP PF
         TAAJODHI   Display file
         TAAJODHC15   Workstation type commands

  Job Queue entries
       TAAJODHR16  RPG Pgm
         TAASYSVX   CVTSBSD SBSJBQENT PF
         TAAJODHJ   Display file
         TAAJODHC16   Job Queue entry commands
         TAAJODHC26   Retrieve job queue text description

Structure - Continued
---------------------

  Routing entries
       TAAJODHR17  RPG Pgm
         TAASYSVP   CVTSBSD SBSRTGENT PF
         TAAJODHK   Display file
         TAAJODHC17   Routing entry commands

  Communication entries
       TAAJODHR18  RPG Pgm
         TAASYSVP   CVTSBSD SBSCMNENT PF
         TAAJODHL   Display file
         TAAJODHC18   Communication entry commands

  Remote location names
       TAAJODHR20  RPG Pgm
         TAASYSVS   CVTSBSD SBSRMTLOC PF
         TAAJODHM   Display file
         TAAJODHC20   Pre-start job commands

  Pre-Start job entries
       TAAJODHR20  RPG Pgm
         TAASYSVU   CVTSBSD SBSPRESTR PF
         TAAJODHN   Display file
         TAAJODHC20   Pre-start job commands

ADDDEVE     Cmd
   TAAJODHC2  CL pgm

ADDRMTLOCE  Cmd
   TAAJODHC3  CL pgm
					

Added to TAA Productivity tools March 15, 2002


Home Page Up to Top