TAILOR
Using skeleton tailoring, you can manipulate the contents of members of partitioned data sets and REXX or TSO CLIST variables.
Skeleton tailoring reads the member line by line (or examines the variables) while substituting variable indicators within these lines or variables. At the same time, it follows a number of directives to generate a member of a partitioned data set (or a set of output variables).
Skeleton tailoring can be used for a number of purposes including JCL tailoring. Because its output can be a set of variables and these variables can be directly submitted by an IMFEXEC JESSUBM command, you need to review the feasibility of using the IMFEXEC TAILOR and IMFEXEC JESSUBM command together.
Command | Parameters |
|---|---|
TAILOR | DD MEMIN() | STEMIN() MEMOUT() | STEMOUT() [DD()] [INCLUDE()] [SEARCH()] [DEBUG] | NODEBUG] |
The following table describes the parameters:
TAILOR command parameters
Parameter | Function | Notes |
|---|---|---|
DD | Name of the DD statement where the MEMIN() member is read and the MEMOUT() member is written | Can be a maximum eight characters in length and must conform to the DD name specification. |
MEMIN() | Name of the PDS member to read | Can be a maximum eight characters in length and must conform to the member name specification. Either DD() and MEMIN() or STEMIN() must be specified. When MEMIN() is specified DD() must also be specified. MEMIN() and STEMIN() are mutually exclusive. |
MEMOUT() | Name of the PDS member to which the output is written | Can be a maximum eight characters in length and must conform to the member name specification. MEMOUT() and STEMOUT() are mutually exclusive. Either DD() and MEMOUT() or STEMOUT() must be specified. When MEMOUT() is specified DD() must also be specified. |
STEMIN() | Variable stem prefix for input lines This prefix is followed by a period that is followed by a number. The 'var.0' contains the count of variables supplied and var.1 to var. n contain the data input to the tailor function. | Can be a maximum of 26 characters in length, and must conform to variable name conventions. Either DD() and MEMIN() or STEMIN() must be specified. When MEMIN() is specified DD() must also be specified. MEMIN() and STEMIN() are mutually exclusive. The 0 index is assumed to contain the number of variables to process. If var.0 is greater than 99999, an error message will be issued, a nonzero return code set, and the last variable used will be var.99999. |
INCLUDE() | Name of a DD statement from which to process)INCLUDE directives | If not specified, no substitutions are performed. Can be a maximum eight characters in length and must conform to the DD name conventions. This DD statement will be used for all directives. |
SEARCH() | Search order used to satisfy variable references This parameter defines the variable pools and the order to process them. | Possible values areTSOLOCALSHAREDPROFILE Multiple values can be specified. They can be combined or separated by commas or spaces. The search order is position dependent and can contains multiple values. If you specify SEARCH(‘’), no variable substitution is performed but the directives are interpreted. SEARCH() must include TSO if the input stream uses the )DO directive with an index specified. Long variables are not supported. The default is ‘’, which means no substitution. |
STEMOUT() | Variable stem prefix for output lines This prefix is followed by a period that is followed by a number. The 'var.0' contains the count of variables created from the TAILOR function, and var.1 to var. n contain the data lines returned from the tailor function. | The result of the tailoring processing is saved into the stem variables. All existing variables are overwritten and the number of generated variables is placed into the 0 index. The maximum length is 26 characters and it must conform to the variable naming conventions. Output from the IMFEXEC TAILOR command is truncated at 80 characters. Either DD() and MEMOUT() or STEMOUT() must be specified. When MEMOUT() is specified DD() must also be specified. If more than 99999 lines are generated, an error message will be issued, a non-zero return code will be set, and the last variable generated will be var.99999. |
DEBUG | Traces every line and every pass to the BBI journal | n/a |
Condition codes are listed in the following table:
Value | Description |
|---|---|
4 | An error occurred while reading input for tailoring from variables or a PDS member. Messages indicate the specific condition. |
8 | A catastrophic error processing the input occurred. |
12 | An error occurred while writing output to variables or a PDS member. |
16 | A syntax error occurred while parsing parameters, such as mutually exclusive or inclusive. |
In the following example, the member Recover is read from the PDS allocated with the DD statement AOJCL.
Variable substitution as well as any tailoring processing is performed. When a variable is found in the input stream, the TSO pool (followed by the local pool) is searched for the purposes of substitution.
The results of the search are placed into the REXX stem variable TEMPTLR.X.
CLIST example:
This section contains the following topics :
Related topic