The keywords DSLIST_RM_ENABLED, DSLIST_RM_COMMAND, and DSLIST_RM_APPLID define an external interface to DFSMSrmm or an equivalent product. This can be used to allow the Data Set List utility (ISPF Option 3.4) to process selected line commands for data sets stored on tape or some other removable media.

The Data Set List utility handles return codes from the removable media interface command as follows:

0 or 4

Normal completion. Data Set List utility continues processing.

8

Error. Data Set List utility stops processing. Any further line commands are not processed. No error message is issued, allowing the tape/removable media interface to issue an error message via the ISPF SETMSG service.

12

Error. Data Set List utility issues an error message and stops processing. Any further line commands are not processed.

Other

Severe Error. Data Set List utility stops processing. Any further line commands are not processed. If the command was not found, message ISPD223 is issued, otherwise message ISRU671 is issued.

The command specified by DSLIST_RM_COMMAND should set the return code to 12 for any line commands that are not supported by the interface.

DSLIST_RM_ENABLED

Controls whether support is enabled in ISPF option 3.4 to call the removable media interface for these line commands: I, S, D, R, C, M, P, X, CO, MO. Valid values are YES and NO.

The default is NO.

DSLIST_RM_COMMAND

Specifies a command name, including parameters, to be invoked using the ISPF SELECT CMD service. The command name can be up to 45 characters in length, and may contain 2 special characters:

?

Is replaced with the option 3.4 line command. Two consecutive '?' characters will be replaced with a single '?' and no substitution of the line command will be performed. If '?' is not included within the command, the line command is automatically appended as a parameter to the end of the command.

/

Is replaced with the data set name (ZDLDSN) and the first volume (ZDLVOL), separated by a space. Two consecutive '/' characters will be replaced with a single '/' and no substitution of the data set name and first volume will be performed. Where the '/' is not included within the command, both the data set name and first volume will be automatically appended as a parameters to the end of the command. If a '%' character is specified before the command, the ISPF SELECT CMD service will bypass any attempt to load the command as a load module.

The default value for command is %EDGRPD34, which is equivalent to %EDGRPD34 ? /.

Here are some examples. The examples demonstrate different ways of specifying the DSLIST_RM_COMMAND parameter:

tapecmd ? /

tapecmd OPT(?) /

tapecmd OPT(?) DSV(/) ALTLIB(YES)

DSLIST_RM_APPLID

The syntax for the DSLIST_RM_APPLID keyword is:

DSLIST_RM_ APPLID = applid | NONE

Where applid is the application ID used to invoke the tape interface command defined by DSLIST_RM_COMMAND. Applid is a 1-character to 4-character name. If applid is set to NONE, no application ID will be used. Where the applid is specified, the PASSLIB parameter will also be included on the ISPF SELECT CMD service.

The default is EDG.