Calling GIMXSID

The JCL statements needed to call GIMXSID are:

Figure 1. JCL to call GIMXSID

//job      JOB ...
//step     EXEC PGM=GIMXSID,PARM='options'
//SMPOUT   DD SYSOUT=*
//SMPXTOUT DD DSN=output.dataset,DISP=(NEW,CATLG),
//            SPACE=(TRK,(1,1)),UNIT=SYSALLDA
//SYSIN    DD *
input control statements
/*

EXEC

is the statement used to call GIMXSID. The EXEC statement must specify PGM=GIMXSID. The following options may be specified on the EXEC statement PARM operand:

INVENTORY=IBM | ALL: Specifies which form of the software inventory will be produced. A value of IBM indicates the software inventory will be produced in the form expected by IBM's ShopzSeries. This form of the software inventory identifies all installed FMIDs and only PTFs whose IDs match the naming convention used by IBM. This is the default value.
A value of ALL indicates the software inventory will be produced in a generic form that identifies all installed FEATUREs, FMIDs and PTFs regardless of their naming convention.
LANGUAGE=ENU | JPN: The LANGUAGE option defines which language to use for GIMXSID messages. ENU is for US English, and JPN is for Japanese. LANGUAGE can also be specified as L. If LANGUAGE is not specified, the default is LANGUAGE=ENU.
WAIT=minutesMIN: where minutes is a decimal number between 0 and 9999. The WAIT option is used to control how long GIMXSID should wait if an SMPCSI data set is unavailable because it is in use by another SMP/E task. WAIT=minutesMIN causes GIMXSID to wait for a data set for the specified number of minutes. If a data set is still not available after the specified number of minutes, then GIMXSID stops. If WAIT is not specified, the default is WAIT=60MIN.
WAIT may be specified as WAIT=minutesMIN or WAIT=minutes. The MIN keyword is optional.

SMPOUT

used for GIMXSID messages. The RECFM must be FBA and the LRECL must be 81 or 121. GIMXSID formats messages to 80 characters in length, regardless of the LRECL for SMPOUT.

SMPXTOUT

the output specification for the software inventory data collected by GIMXSID. The output can be a sequential data set, a member of a partitioned data set, or a file in a UNIX file system. The required attributes for the output data set or file are dependent upon the inventory format being produced.

If INVENTORY=IBM is specified on the EXEC statement (or defaulted), then a data set specified on SMPXTOUT must have a RECFM of FB and the LRECL must be 12560. If a file in a UNIX file system is specified, then FILEDATA=BINARY and PATHOPTS(OWRONLY) must be specified on the DD statement.

If INVENTORY=ALL is specified on the EXEC statement, then a data set specified on SMPXTOUT must have a RECFM of VB and the LRECL must be 255 or greater. If a file in a UNIX file system is specified, then FILEDATA=TEXT and PATHOPTS(OWRONLY) must be specified on the DD statement.

SYSIN

specifies an input data set that contains the GIMXSID control statements. The input data set may be sequential, or a member of a partitioned data set. The RECFM must be F or FB and the LRECL must be 80.