Opens a sequential data set or member of a PDS for input or output.
&CONTROL SHRVARS=($DS)
EXEC $DSCALL OPT=OPEN
DD=DD_name
[ ID=path_name ]
[ MEMBER=member_name ]
[ MODE= { INPUT | OUTPUT } ]
This call is used to open a data set or a member of a PDS in preparation for reading (specify MODE=INPUT) or writing (specify MODE=OUTPUT).
Operands:
Specifies that an OPEN action be performed on a data set or member of a PDS.
Specifies the ddname of the data set to be opened. If the ddname represents a concatenated DD, the first data set in the concatenation is opened.
Specifies the ID of a path to be opened for access to the data set. The use of a path ID lets a procedure access more than one file, with the unique path ID used to identify which file is being accessed. The path ID must be specified on subsequent requests such as READ, WRITE, and CLOSE.
If this operand is omitted, the ddname is used as the path ID. If a path with that name already exists, an error is indicated. The path ID is returned in the shared variable &$DSID.
Specifies the member name. To open a PDS that was not allocated with a member name, specify the member name in the call. If the allocation was to a member name, the member name specified in the MEMBER operand overrides it.
Specifies whether the data set is open for input or output.
Return Codes:
Note: For more information about &SYSMSG, &$DSRC, and &$DSFDBK, see Return Codes and Feedback Codes.
Return Variables:
Path ID
Example: OPT=OPEN
EXEC $DSCALL OPT=OPEN DD=SYSDD MODE=OUTPUT + MEMBER=TEST01
Note: If the original allocation was to a PDS or a member of a PDS, the member is opened. If the allocation was for a sequential data set, the data set is opened.