Modify the ARSLOAD procedure

About this task

The ARSLOAD procedure starts the load daemon (long running task) that captures SYSOUT directly from spool and loads it into Content Manager OnDemand. SeeAutomating the data loading process for details and other requirements.

A sample ARSLOAD procedure is provided in the SARSINST library. You must customize the procedure for your environment and copy the customized procedure into the PROCLIB concatenation. The STEPLIB DDs should be customized to your local naming conventions.

The following is the sample ARSLOAD procedure.

Figure 1. Sample ARSLOAD procedure.

//ARSLOAD  PROC
//ARSLOAD  EXEC PGM=ARSLOAD,REGION=0M,TIME=NOLIMIT,
//  PARM=('/-h ARCHIVE -C Q')
//STEPLIB  DD DISP=SHR,DSN=ARS.V9R5M0.SARSLOAD
//         DD DISP=SHR,DSN=DB2.V10R1M0.SDSNEXIT
//         DD DISP=SHR,DSN=DB2.V10R1M0.SDSNLOAD
//         DD DISP=SHR,DSN=ACIF.V4R5M0.SAPKMOD1
//**********************************************
//SYSPRINT DD SYSOUT=*,RECFM=FBA,LRECL=121,BLKSIZE=6050
//SYSOUT   DD SYSOUT=*

The following list explains the highlighted JCL statements:

//ARSLOAD EXEC PGM=ARSLOAD ... PARM=('/-h ARCHIVE -C Q')

Specifies the parameters for the ARSLOAD program. The parameters are documented in the ARSLOAD section of the IBM® Content Manager OnDemand for z/OS®: Administration Guide. The example specifies the following parameters:

-h ARCHIVE: Specifies the name of the Content Manager OnDemand instance to process. The system locates the specified instance name in the ARS.INI file to determine the IP address, host name alias, or fully-qualified host name of the library server. The example -h parameter specifies an instance name of ARCHIVE.
Note: In the JCL, the / character to the left of the -h parameter ensures that everything to the right will be treated as program parameters and not as Language Environment® runtime options.
-C Q: Specifies the JOB CLASS to monitor for SYSOUT to load into Content Manager OnDemand. The example -C parameter specifies that CLASS Q be monitored.

You can also specify the following parameters:

-F form: Specify the FORM to monitor.
-W external writer: Specify the external writer name to be used.

Note: A Content Manager OnDemand administrative user ID and password must be specified to the ARSLOAD procedure, or the ARS.PTGN exit might be used to allow ARSLOAD to run without needing to specify a user ID and password. You can specify the -u userid and -p password parameters to the PARM keyword on the EXEC statement or you can use the ARS.PTGN exit. See Unified login (ARS.PTGN) exit for details and requirements about the ARS.PTGN exit. In Figure 1, because the -u and -p parameters are omitted from the PARM keyword on the EXEC statement, the ARS.PTGN exit must be used; otherwise, the ARSLOAD procedure will fail.

//STEPLIB DD ... DSN=ACIF.V4R5M0.SAPKMOD1

Specifies the ACIF library, which must be customized for the local naming conventions.