List PDS Members with CAZ2LPDS › Input Parameters

Input Parameters

Specify the input parameters with the following syntax:

keyword(value)[,keyword(value)][,keyword(value)]…

Currently, the following input parameters are supported:

FUNC(function)

An optional parameter that specifies a function you can perform. The permitted values for function are:

LISTDIR

The LISTDIR value returns a list of PDS members. One line of output is produced for each PDS member name. The PDS member name begins in position 1 of the output record. This value is the default.

ENV(environment)

An optional parameter that specifies the executing environment. The permitted values for environment are:

BATCH

The BATCH value indicates standard batch execution. This value is the default.

REXX

The REXX value indicates that CAZ2LPDS is being called from a REXX environment. This parameter is not required when executing under REXX. However, it must be specified if you want to return information on the REXX stack or if you want to return a result value in the RESULT(any value) parameter.

If ENV(REXX) is specified, you can specify ODDN(@RXSTACK) to cause the returned member list be written to the REXX stack. Additionally, you can specify the RESULT(any value) parameter to cause a descriptive result string be returned.

IDDN(ddname|SYSIN)

An optional parameter that specifies the DDNAME of the input PDS. The specified DDNAME must be allocated. The PDS must currently have an LRECL of 80 characters. The default value is SYSIN.

ODDN(ddname|SYSPRINT)

An optional parameter that specifies the DDNAME of the sequential output file. The specified DDNAME must be allocated. The output file must have the characteristics defined in Output File Characteristics. The default value is SYSPRINT.

If the calling program is REXX and the ENV(REXX) parameter has been specified, the returned member list can be written to the REXX stack by specifying ODDN(@RXSTACK). The list can then be retrieved using the REXX PULL statement as shown in Write a List of Members to the REXX Stack, see REXX Execution Examples.

RESULT(any value)

An optional parameter that returns a text string that describes the return code. This parameter is available only when REXX calls it. The ENV(REXX) parameter must also be specified. If the ENV(REXX) parameter is not specified, the only feedback the caller receives is the return code. No default exists.

Upon return to the calling REXX program, the contents of the parameter is “RESULT(result string)”. The “result string” is the text string describing the return code. The result string can then be used as shown in the following REXX coding examples.