Running Content Manager OnDemand server commands

About this task

The examples below show some of the ways that the ARSLOAD utility program can be executed. They illustrate how the same path, required parameter values and optional parameter values are entered to the z/OS® system using the different methods of execution. The examples in the chapters which follow will present only the syntax for the path, required parameter values and optional parameter for the purposes of illustrating their use for each utility program. Variation for method of execution as illustrated below is not factored into further examples.

When running commands by using JCL, it may be necessary to set environment variables to control program processing. For jobs that use BPXBATCH, the STDENV DD statement provides a means of setting environment variables. See z/OS UNIX System Services Command Reference for more information.

For JCL that does not use BPXBATCH, the Language Environment® ENVAR runtime option provides a means of setting environment variables. See z/OS Language Environment Programming Reference for more information. Additional environment variables can be set from an MVS data set or HFS file by using the _CEE_ENVFILE environment variable. See z/OS V1R1.0 C/C++ Programming Guide for details about the _CEE_ENVFILE environment variable. Note that for an MVS data set, the data set must be allocated with RECFM=V.

Important: Examples of commands may appear in one of the following two formats:

  /usr/lpp/ars/V10R5M0/bin/arsmaint -cdmsv >> /tmp/arsmaint.log 2>&1

/usr/lpp/ars/V10R5M0/bin/arsmaint -cdmsv
       >> /tmp/arsmaint.log 2>&1

However, when you type the command, you must enter the entire command syntax on a single line.

Procedure

To run under USS from TSO using the OMVS command:
1. In a TSO session, enter OMVS into the command line and hit enter.
2. In the next screen, enter the parameter values into the command line: "/usr/lpp/ars/V10R5M0/bin/arsload -u USERID -p PASSWORD -d dl -h systemid -C Q"

To run as a started task, enter the following command on the SDSF command line: /S ARSLOAD

The following job stream will be submitted to the z/OS system:

//ARSLOAD  JOB MSGLEVEL=1
//STARTING EXEC ARSLOAD

and the following procedure will be executed:

//ARSLOAD PROC
//ARSLOAD EXEC PGM=ARSLOAD,REGION=0M,TIME=NOLIMIT,
// PARM=('/-h ARCHIVE -C Q')
//STEPLIB DD DISP=SHR,DSN=ARS.V10R5M0.SARSLOAD
  // DD DISP=SHR,DSN=DB2.V10R5M0.SDSNEXIT
    // DD DISP=SHR,DSN=DB2.V10R5M0.SDSNLOAD
// DD DISP=SHR,DSN=APK.ACIF231.SAPKMOD1
//********************************************** 
//SYSPRINT DD SYSOUT=*,RECFM=FBA,LRECL=121,BLKSIZE=6050
//SYSOUT DD SYSOUT=*
//***********************************************
//* The following 3 DD statements should be uncommented and
//* customized if the PDF indexer is used.
//*********************************************** 
//*ADOBERES DD DSN=ADOBE.PDFLIB.RESOURCE.INDEX(ADOBERES),DISP=SHR
//*ADOBEFNT DD DSN=ADOBE.PDF405.PLUSP1C.ADOBEFNT.LST,DISP=SHR
//*TEMPATTR DD DSN=ADOBE.PDF405.PLUSP1C.TEMPATTR,DISP=SHR

To invoke a batch job JCL EXEC statement, use the sample JCL.

//STEP1 EXEC PGM=ARSLOAD,REGION=0M,
// PARM=('ENVAR("_CEE_ENVFILE=DD:MYVARS")/-u user -p password -h ARCHI+
// VE -C R ')
//STEPLIB DD DISP=SHR,DSN=ARS.V10R5M0.SARSLOAD
  // DD DISP=SHR,DSN=DB2.V10R5M0.SDSNEXIT
    // DD DISP=SHR,DSN=DB2.V10R5M0.SDSNLOAD
// DD DISP=SHR,DSN=apk.acif231.SAPKMOD1
//SYSPRINT DD SYSOUT=*
//CEEDUMP DD SYSOUT=T
//MYVARS DD DUMMY