Use this system macro to provide parameter validation and transformation,
as well as to build the correct linkage for a specific macro. This
macro is used by all DASD FIND and FILE-type macros for performing this common
processing.
Format
- label
- The symbolic name from the subject macro statement.
- VALID=n
- The number of valid positional parameters for the subject macro.
This parameter is required.
- ACTUAL=m
- The number of actual positional parameters entered for the subject
macro. The value from the assembler statement N'&SYSLIST, the
number of items in the SYSLIST. This parameter is required.
- MACRO=macroname
- The name of the subject macro (for example the FINDC macro). This
parameter is required.
- LEVEL=l
- The value specified for the data level parameter. D0-DF are
the only valid values.
- GDS=Y|N
- The value specified for the GDS parameter, provided the subject macro
supports the GDS parameter. Only Y or N are valid values for the GDS
parameter.
- TAG=Y|N
- The value specified for the TAG parameter, provided the subject macro
supports the TAG parameter. Only Y or N are valid values for the TAG
parameter.
- TYPE=P|D
- The value specified for the positional parameter that describes the type
of record (primary or duplicate) required for the FINSC and FILSC
macros. Only P or D are valid values for the TYPE parameter.
- EXTEND=E
- The value specified for the positional parameter that indicates the use of
the extended file address reference word for the FNSPC and FLSPC
macros. Only E is a valid value for the EXTEND parameter.
- ERROR=label1
- The value specified for the error label (label1) positional parameter if
the subject macro supports the error label positional parameter.
- DECB=d
- The value specified for the DECB parameter if the subject macro supports
the DECB parameter.
- PIA=p
- The value specified for the PIA parameter if the subject macro supports
the PIA parameter.
- ENTRY=rtn
- The control program (CP) entry point that the macro is supposed to
call.
Entry Requirements
See the applicable macro for more information.
Return Conditions
See the applicable macro for more information.
Programming Considerations
- This macro does not validate that the specified parameters are valid for
the subject macro. The coder of the subject macro must not
specify parameters that are not supported by the subject macro. For
example, do not specify the TAG parameter for a FINDC macro.
- The FTSTC macro can be used on any I-stream.
Examples
None.