Input parameter data set contents

The input parameter data set is a fixed-block 80-byte record sequential data set. Each input parameter consists of a keyword and an associated value. The rules for the input parameter data set are as follows:

There must be one keyword with its associated parameter data per 80-byte record.
All keywords must begin in column one of the records.
No blanks are allowed after the keyword and before the equal sign
No blanks are allowed after the equal sign and before the first parameter value
Any data read from the input parameter data set that is not a recognized keyword parameter is ignored and processing continues.

The keywords and parameters passed to the GIMXTRX program are as follows:


GIMXTRX input parameters

>>-------------------------------------------------------------><

SUFFNC keyword

|--SUFFNC=--+-LSTTZN-+------------------------------------------|
            '-BMPTZN-'   

SUFGBL keyword

|--SUFGBL=--globaldsn-------------------------------------------|

SUFUNIT keyword

|--SUFUNIT=--unit-----------------------------------------------|

SUFVOL keyword

|--SUFVOL=--volume----------------------------------------------|

SUFTGT keyword

            .------------.   
            V            |   
|--SUFTGT=----tzone name-+--------------------------------------|

SUFFNC

This is the name of the function to be processed by the GIMXTRX program. The two allowable values are

LSTTZN: Generate a list of target zone names.
BMPTZN: Create a BITMAP of a set of target zones.

This is a required parameter.

There can only be one function executed per invocation of GIMXTRX.

SUFGBL

This is the data set name containing the GLOBAL zone to be processed. This parameter is 44 characters long. This is a required parameter.

SUFUNIT

This is the UNIT value used to allocate a new output data set. The value is up to 8 characters long. This parameter is optional. If no UNIT value is specified, GIMXTRX uses a default UNIT value of SYSALLDA when allocating a new output data set.

SUFVOL

This is the work volume used to allocate the output data set. The value is six characters long, and must be a valid MVS™ volume name. This is an optional parameter. If no volume is specified, GIMXTRX will attempt to allocate the output data set without a volume serial.

SUFTGT

This is the list of target zone names that will be queried. Each target zone name is 7 characters long separated by one blank space. If a target zone name is less than 7 characters long it must be left-justified and padded with blanks. Each SUFTGT record can contain up to nine target zones. This is a required parameter when SUFFNC=BMPTZN. It is not required when SUFFNC=LSTTZN.

There can be multiple instances of the SUFTGT record to allow for situations where a single 80-byte record cannot contain the required input data.