Commands for FRPBATCH

Some MODIFY (F) and FRPBATCH commands are equivalent.

The job control statements are:

EXEC

Specifies the program name (PGM=FRPBATCH) and the program parameters. The parameters must be comma delimited and can be supplied in any order. Each parameter is in the format of parameter=value.

XCFGROUP

The name of the XCF group in which the RS is located. The value of this parameter is the same as the value of the XCF_GROUP_NAME parameter in the FRPCFG member of the IMS PROCLIB data set.

LANG

The language for output messages. Only ENU is supported. If this parameter is omitted, ENU is used.

The following example is an EXEC statement:

EXEC PGM=FRPBATCH,PARM=(’XCFGROUP=FRPGRUP1’,’LANG=ENU’)

SYSPRINT DD

Defines a data set for general messages and information. DCB attributes for this data set are RECFM=FBM and LRECL=133.

FRPLIST DD

Defines a data set for the LIST command output. If this statement is omitted, the output of the LIST command is written to the SYSPRINT DD output data set. DCB attributes for this data set are RECFM=FBM and LRECL=133.

The commands to be processed are specified on the SYSIN control cards. The SYSIN control cards must be entered in columns 1 - 72 of the input stream. Each statement has the following general form:

command_name parameter1 parameter2(value) /*inline comment
*Full-line comment

The following rules apply:

• The command_name is the first item of a command. It is followed by a space ( ), and one or more parameters.
• If a command contains more than one parameter, each parameter must be separated by one or more spaces ( ), a comma (,), or both.
• A parameter can have a value. The value of a parameter is enclosed in parentheses ().
• Command names, parameters, and values are converted by the program to uppercase.
• To enter an inline comment, type a forward slash followed by an asterisk (/*). Subsequent characters on the same line are ignored by the program.
• To enter a full-line comment, type an asterisk (*) in column 1. All characters on that line are ignored by the program.
• To break a command over multiple lines, use one of the following continuation characters:
  • Use a hyphen (-) to separate parameters for the same command across multiple lines. The hyphen does not delete the leading separator from continued lines. For example:

    RENAME REPOSITORY(REPOSITORY_NAME) -
    REPOSITORYNEW(REPNEWNAME)

  • Use a plus sign (+) to enter a single parameter and its value on multiple lines. It deletes the leading separator from continued lines. The plus sign must immediately follow the last character on a line. For example:

    START REPOSITORY
    (REPOSIT+
    ORY_NAME)

The following sample is JCL that runs the FRPBATCH interface with the various FRPBATCH commands:

//FRPBAT   EXEC PGM=FRPBATCH,PARM='XCFGROUP=FRPGRUP1' 
//SYSPRINT DD SYSOUT=*            
//SYSIN    DD *                   
//* 
 ADD REPOSITORY(IMSRSC_REPOSITORY)+
     REPDSN1RID(IMSTESTS.REPO.IMSPRI.RID)+
     REPDSN1RMD(IMSTESTS.REPO.IMSPRI.RMD)+
     REPDSN2RID(IMSTESTS.REPO.IMSSEC.RID)+
     REPDSN2RMD(IMSTESTS.REPO.IMSSEC.RMD)+
     REPDSN3RID(IMSTESTS.REPO.IMSSPR.RID)+
     REPDSN3RMD(IMSTESTS.REPO.IMSSPR.RMD)+
     AUTOOPEN(YES)
 //*
 START REPOSITORY(IMSRSC_REPOSITORY)+
       MAXWAIT(30,CONTINUE)      

 //* 
 LIST REPOSITORY(IMSRSC_REPOSITORY) 

 //* 
 STOP REPOSITORY(IMSRSC_REPOSITORY)+ 
      MAXWAIT(30,CONTINUE)

 //*
 RENAME REPOSITORY(IMSRSC_REPOSITORY) REPOSITORYNEW(IMSRSC_TEST_REPOSITORY)

 //* 
 UPDATE REPOSITORY (IMSRSC_TEST_REPOSITORY) -
 REPDSN1RID(IMSTESTS.TESTREPO.IMSPRI.RID) -
 REPDSN1RMD(IMSTESTS.TESTREPO.IMSPRI.RMD) -
 AUTOOPEN(NO)

 //* 
 DELETE REPOSITORY(IMSRSC_TEST_REPOSITORY)