Sample library (SEQQSAMP)
The SEQQSAMP library contains samples to help you install and customize HCL Workload Automation for Z.
In most cases, you need only add installation-specific JCL to adapt a member in SEQQSAMP to your requirements. Sample library (SEQQSAMP) lists all members in the SEQQSAMP library and provides a brief description of each member. The following pages describe the samples relating to installing HCL Workload Automation for Z 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 Developer's Guide: Driving HCL Workload Automation for Z.
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. |
| EQQALLOC | JCL to allocate the HCL Workload Automation for Z distribution and target libraries. |
| EQQALSMP | Sample JCL to allocate and initialize the SMP/E environment needed to install HCL Workload Automation for Z |
| 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, processing EQQTROUT or EQQDROUT data set. Note: EQQAUDIB
can be used successfully only if the EQQTROUT dsname and the EQQAUDIT
output dsn fields in the EQQJOBSA panel are typed out. |
| EQQBENCO | Sample JCL that encrypts the password defined in the OSLCOPTS initialization statement used to configure HCL Workload Automation for Z to integrate with OSLC. |
| EQQBENCR | Sample EQQE2EPW JCL to run the utility that encrypts the Windows™ passwords set in the USRPSW parameter of the USRREC statements. |
| 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. |
| EQQDBREP | Contains the SQL statements to create the DB2 reporting objects. |
| EQQDDDEF | Sample job to allocate DDDEFs in SMP/E. |
| 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. |
| EQQFLEX | Sample job used by the controller at daily planning, to communicate the number of jobs that were submitted on z-centric and dynamic agents to the license server. |
| EQQICNVS | Sample job to migrate VSAM files. |
| EQQINIRE | Sample JCL to create the DB2 reporting objects. |
| 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. |
| EQQJES21 | JCL to assemble and link-edit the JES2 EXIT51. |
| EQQJES2 | JCL to assemble and link-edit a JES2 exit. |
| 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. |
| EQQMIGRE | Sample JCL to migrate DB2 reporting objects from the previous version. |
| EQQMKDIR | Sample exec to create directories. |
| EQQNCFCT | Sample parameters for an SNA connection between controller and tracker. |
| EQQNETW1 | REXX™ EXEC that receives HCL Workload Automation for Z WTO messages and issues z/OS 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. |
| EQQPCS01 | Allocates data sets that need to be unique within the SYSPLEX. |
| EQQPCS02 | Allocates data sets that need to be unique to each ZOS image in the SYSPLEX. |
| EQQPCS03 | Generates a job that allocates VSAM copy data sets. |
| EQQPCS04 | Defines Data Store VSAM files and initializes them. |
| EQQPCS07 | Allocates VSAM data sets for Restart and Cleanup. |
| EQQPCS08 | Allocates USS files for Java™ utilities enablement. |
| EQQPCS09 | Allocates the GDG root and VSAM data set used as input by the archiving process supporting the Dynamic Workload Console reporting feature. |
| EQQPCS10 | Creates the SSL work directory used for TCP/IP communication with the controller. |
| EQQPCS11 | Allocates data sets (EQQOUCEV and EQQOUCKP) used for the retrieval of job logs in the z-centric environment with the Output collector. |
| EQQPCS12 | Allocates the GDG root to archive the MLOG files. |
| 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 HCL Workload Automation for Z, to initiate purge of DLF objects. |
| EQQRECVE | Sample SMP/E RECEIVE JCL for the controller software |
| EQQREPRO | Is invoked by EQQSMLOG to copy the contents of the outgoing MLOG file onto the GDG data set. You must copy this sample to the PARMLIB of the controller. |
| 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. |
| EQQSMF | JCL to assemble and install the SMF exits. |
| EQQSMLOG | Sample procedure that creates the GDG data set where the outgoing MLOG file is archived when the MLOG switching function takes effect. Uses the EQQREPRO input parameter. |
| 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. |
| 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 an HCL Workload Automation for Z 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®. |
| 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. |
| EQQXML01 | Sample XML file for data set triggering event rule definitions. |
| 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. |