Appendix A. Sample library (SEQQSAMP)
The SEQQSAMP library contains samples to help you install, migrate, and customize Tivoli Workload Scheduler for z/OS. In most cases, you need only add installation-specific JCL to adapt a member in SEQQSAMP to your requirements. Table 49 lists all members in the SEQQSAMP library and provides a brief description of each member. The following pages describe the samples relating to installing Tivoli Workload Scheduler for z/OS in more detail. Descriptions of other sample-library members are included in the book that describes the function demonstrated by the sample. For example, program-interface samples are described in Tivoli® Workload Automation: Developer’s Guide: Driving Tivoli Workload Scheduler for z/OS
Some of the samples provided address a specific function and you might be able to use the sample unchanged in your environment. If you need to change a sample member, it is advisable to copy the source to a separate library. The original sample member is then available for reference. It is also recommended that you create an SMP/E usermod for each sample member you run in the production environment. Changes to the sample source code will then be flagged for your attention, and subsequent updates can be reflected in the production code as soon as possible.
| Member | Brief description |
|---|---|
| EQQ9RF01 | Sample RACF® router table entry to enable security environment |
| EQQ9RFDE | Sample RACF class descriptor entry to enable security environment |
| EQQ9SM01 | JCL to install RACF router table update |
| EQQ9SMDE | JCL to install RACF class descriptor update |
| EQQACPTx | Sample SMP/E ACCEPT JCL for the controller software, where the value of x depends on the language |
| EQQACTR1 | Sample SMF exit IEFACTRT, written in assembler, to enable job-tracking |
| EQQAIXST | Parameters used by the EQQX9AIX and EQQAIXTR samples |
| EQQAIXTR | Sample tracker running on AIX®, used with EQQX9AIX |
| EQQBENCR | Sample EQQE2EPW JCL to run the utility that encrypts the Windows passwords set in the USRPSW parameter of the USRREC statements. |
| EQQDDDEF | Sample job to allocate DDDEFs in SMP/E |
| EQQALLOC | JCL to allocate the Tivoli Workload Scheduler for z/OS distribution and target libraries. |
| EQQALSMP | Sample JCL to allocate and initialize the SMP/E environment needed to install Tivoli Workload Scheduler for z/OS |
| EQQAPISM | ASCII file containing a sample API application |
| EQQAPPLx | Sample SMP/E APPLY JCL for the controller software, where the value of x depends on the language |
| EQQAUDIB | Sample to invoke EQQAUDIT in batch mode outside
of the dialog
Note:
EQQAUDIB can be used successfully only
if the EQQTROUT dsname and the EQQAUDIT
output dsn fields in the EQQJOBSA panel are filled out. |
| EQQBSCAN | Batch loader sample to validate an application description |
| EQQBSUBS | Batch loader sample to create four application descriptions and two operator instructions. Output is directed to a subsystem. |
| EQQBVSAM | Batch loader sample to create an application description and two operator instructions. Output is directed to a VSAM data set that is allocated by the sample. |
| EQQCHKEV | A sample JCL to display EQQTWSIN and EQQTWSOU event data set content information |
| EQQCLEAN | Sample procedure invoking EQQCLEAN program |
| EQQCONOP | Sample parameters used by EQQCONO |
| EQQCONO | Sample started task procedure for controller only |
| EQQCONP | Sample initial parameters for a controller and tracker in the same address space |
| EQQCON | Sample started task procedure for a controller and tracker in the same address space |
| EQQCVM2 | Sample to enable submission and tracking on VM systems using EQQUX009 |
| EQQCVM | Sample to enable job-tracking facilities on VM systems |
| EQQDBENC | Contains the JCL to encrypt the password in the DBOPT statement |
| EQQDBOPT | Sample DBOPT statement |
| EQQDELDI | JCL and usage notes for the data set deletion function |
| EQQDLFX | Assembler installation sample of DLF connect/disconnect exit |
| EQQDPCOP | JCL and usage notes for copy VSAM function |
| EQQDPX01 | DP batch sample user exit to update the scheduling environment |
| EQQDSCL | Batch Clean Up sample |
| EQQDSCLP | Batch Clean up sample parameters |
| EQQDSECT | Assembler version of PIF data areas |
| EQQDSEX | Batch Export sample |
| EQQDSEXP | Batch Export sample parameters |
| EQQDSIM | Batch Import sample |
| EQQDSIMP | Batch Import sample parameters |
| EQQDSRG | Batch sample reorg |
| EQQDSRI | Batch Recovery index |
| EQQDSRIP | Batch Recovery index parameters |
| EQQDST | Sample procedure to start Data Store |
| EQQDSTP | Parameters for sample procedure to start Data Store |
| EQQE2EP | Sample initial parameters for server and batch to define if the end-to-end scheduling with fault tolerance capabilities is active |
| EQQICNVH | Sample job to migrate history DB2® tables |
| EQQICNVS | Sample job to migrate VSAM files |
| EQQINIDB | Sample to create the history data base |
| EQQISMKD | Sample job to run EQQMKDIR exec for directories |
| EQQJCCTB | JCL to assemble a JCC message table macro definition |
| EQQJCLIN | Sample JCL to start program EQQPDLF |
| EQQJER2U | Sample to restore the EXIT7 as a JES2 usermod |
| EQQJER2V | Sample to restore the EXIT5 as a JES2 usermod |
| EQQJER3U | Sample to restore the EQQUX191 and EQQUX291 as JES3 usermods |
| EQQJES2 | JCL to assemble and link-edit a JES2 exit |
| EQQJES21 | JCL to assemble and link-edit the JES2 EXIT51 |
| EQQJES2U | JCL to install the JES2 EXIT7 as an SMP/E usermod |
| EQQJES2V | JCL to install the JES2 EXIT51 as an SMP/E usermod |
| EQQJES3 | JCL to assemble and link-edit a JES3 exit |
| EQQJES3U | JCL to install a JES3 exit as an SMP/E usermod |
| EQQJVXIT | Sample assembler JCL-variable-substitution exit. Also used for variable substitution in System Automation commands |
| EQQLSJCL | Sample JCL to invoke the EQQLSENT macro |
| EQQMKDIR | Sample exec to create directories |
| EQQNCFCT | Sample parameters for an SNA connection between controller and tracker |
| EQQNETW1 | REXX EXEC that receives Tivoli Workload Scheduler for z/OS WTO messages and issues MVS™ commands |
| EQQNETW2 | PL/I NetView® command processor that uses EQQUSINT to change the status of operations |
| EQQNETW3 | REXX EXEC that uses EQQEVPGM to change the status of operations |
| EQQOCWTO | Sample job to assemble and linkedit the IPOWTO routine used by the PIF REX sample |
| EQQORST | Resets the USS environment for the end-to-end scheduling with fault tolerance capabilities |
| EQQOS2ST | Parameters used by the EQQX9OS2 and EQQOS2TR samples |
| EQQOS2TR | Sample tracker running on OS/2, used with EQQX9OS2 |
| EQQPCS01 | Allocates data sets that need to be unique within the SYSPLEX |
| EQQPCS02 | Allocates data sets that need to be unique to each MVS image in the SYSPLEX |
| EQQPCS03 | Generates a job that allocates VSAM copy data sets |
| EQQPCS04 | Defines Data Store VSAM files and initializes them |
| EQQPCS05 | Allocates files used by a controller to enable fault-tolerant workstations |
| EQQPCS06 | Allocates VSAM data sets for integration with the end-to-end scheduling with fault tolerance capabilities |
| EQQPCS07 | Allocates VSAM data sets for Restart and Cleanup |
| EQQPIFAD | Program-interface PL/I sample that creates a two-operation application in the AD database |
| EQQPIFAP | Program-interface PL/I sample that resolves JCL variables |
| EQQPIFCB | Program-interface assembler samples for various current plan or long-term plan actions |
| EQQPIFCL | Program-interface assembler sample that uses the DAYSTAT command to return work or free status for a particular date |
| EQQPIFDJ | Program-interface assembler sample, deletes JCL for completed occurrences from JS data set |
| EQQPIFJC | Program-interface COBOL sample to manipulate JCL variable tables |
| EQQPIFJD | Program-interface PL/I sample that can either list or delete records in the JCL repository data set (JS) |
| EQQPIFJV | Program-interface PL/I sample to manipulate JCL variable tables |
| EQQPIFJX | Sample to maintain the JCL repository |
| EQQPIFOP | Program-interface REXX sample to modify an operation in the current plan |
| EQQPIFPR | Program-interface REXX sample to list all cyclic periods |
| EQQPIFWI | Program-interface PL/I sample to modify capacity values in an open interval of a current plan workstation |
| EQQPROC | Sample procedure, started by Tivoli Workload Scheduler for z/OS, to initiate purge of DLF objects |
| EQQRECVx | Sample SMP/E RECEIVE JCL for the controller software, where the value of x depends on the language |
| EQQRETWT | Sample program to simulate abends, return codes and waits |
| EQQRMDS | Usage notes for the job-log-retrieval exit object code to interface to RMDS |
| EQQRXSTG | An assembler routine to get and free storage for the REXX program-interface samples |
| EQQSAMPI | JCL to load sample data for application descriptions, operator instructions, and workstation descriptions to the databases |
| EQQSERP | Sample initial parameters for a Server |
| EQQSER | Sample started task procedure for a Server |
| EQQSLCHK | JCL to perform a syntactic check on SCRIPT library
members
Note:
EQQSLCHK sample JCL is generated with the following
DD card:
EQQMLOG DD SYSOUT=*"If the EQQMLOG ddname is associated with a physical data set that has not sufficient size , a D37 abend followed by a user abend U4036 might occur. In this case, you must reallocate the EQQMLOG data set with more space. To recreate a new EQQSLCHK sample JCL, run again option 1 (Create sample job JCL) of EQQJOBS |
| EQQSMF | JCL to assemble and install the SMF exits |
| EQQTCPCT | Sample definitions for TCP/IP communication between tracker and controller. |
| EQQTRAP | Sample initial parameters for a Tracker |
| EQQTRA | Sample started task procedure for a Tracker |
| EQQTROPT | Sample TRGOPT statement |
| EQQXML01 | Sample XML file for data set triggering event rule definitions |
| EQQU831 | Sample SMF exit IEFU83 to enable job tracking and optionally include data set triggering support |
| EQQUJI1 | Sample SMF exit IEFUJI to enable job-tracking |
| EQQUSIN1 | EQQUSIN subroutine sample to change the status of an operation |
| EQQUSIN2 | EQQUSIN subroutine sample to change the availability of a special resource |
| EQQUSIN3 | EQQUSIN subroutine sample to change the status of a workstation |
| EQQUSIN4 | EQQUSIN subroutine sample to backup a Tivoli Workload Scheduler for z/OS resource data set |
| EQQUSIN5 | EQQUSIN subroutine sample to update the USERDATA field of an operation. |
| EQQUX001 | Sample job-submit exit |
| EQQUX002 | Sample job-library-read exit |
| EQQUX004 | Sample event-filtering exit |
| EQQUX011 | Sample job-tracking log write exit |
| EQQUX013 | Sample job-tailoring prevention exit |
| EQQUX0N | Sample PL/I start/stop exit, EQQUX000 |
| EQQUX191 | Sample JES3 exit IATUX19 to enable job tracking |
| EQQUX291 | Sample JES3 exit IATUX29 to enable job tracking |
| EQQUX9N | Sample PL/I operation-initiation exit, communicating with VM (EQQUX009) |
| EQQUXCAT | Sample restart and clean up exit for the EQQCLEAN program |
| EQQUXPIF | Sample user exit to validate application descriptions |
| EQQUXSAZ | Sample assembler system command exit, communicating with System Automation invoked in place of EQQUX007 for automation workstations |
| EQQVTAMN | Sample VTAM® definition for SNA connection between tracker and controller |
| EQQVTAMS | Sample VTAM definition for server SNA connection |
| EQQX5ASM | Sample SYSOUT archiving exit |
| EQQX6ASM | Sample incident-record-create exit |
| EQQX6JOB | Sample batch-job skeleton JCL used by EQQX6ASM |
| EQQX7ASM | Sample change-of-status exit |
| EQQX7JOB | Sample batch-job skeleton JCL used by EQQX7ASM |
| EQQX9AIX | Sample assembler operation-initiation exit, communicating with AIX |
| EQQX9OS2 | Sample assembler operation-initiation exit, communicating with OS/2 |
| EQQXCFCT | Sample definitions for XCF connection between tracker and controller |
| EQQXIT51 | Sample JES2 EXIT51 to enable job tracking for JES2 with z/OS® version 1 release 7, and later |
| EQQXIT74 | Sample JES2 EXIT7 to enable job tracking for JES2 level version 4 release 1 and later |
| EQQYCBAG | Sample to unload a group application (and all the applications belonging to it) into a sequential file in Batch Loader Control statement format |
| EQQYCBAT | Run the Batch Command Interface tool |
| EQQYRJCL | Sample JCL to run the Control Language tool |
| EQQYRMSG | Messages used by the Control Language tool |
| EQQYRPRC | Sample procedure to run the Control Language tool |
| EQQYRPRM | Sample initialization parameter file for the Control Language tool |