z/OS ISPF User's Guide Vol II
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Using the slash ( / ) character

z/OS ISPF User's Guide Vol II
SC19-3628-00

If a command, CLIST, or REXX exec requires the data set name in a position other than the first operand or if other operands are needed, you can use the slash ( / ) character to represent the quoted data set name. If no operands are specified after the command, ISPF uses the name of the data set being acted on as the command's first operand.

To specify a member of a partitioned data set, enclose the member name or pattern in parentheses immediately following the / character. You can use this format with the V (view data set), B (browse data set), D (delete data set), E (edit data set), and M (display member list) line commands. For information about these line commands, see Data set list utility line commands.

You may find it helpful to call the SHOWCMD primary command before using the slash ( / ) for the first time. After you call SHOWCMD, a special Data Set List Utility panel appears each time you enter a line command, TSO command, CLIST, or REXX exec on a data set list display. The panel shows you the command you entered and how ISPF expanded, and thus interpreted, that command. See SHOWCMD command for more information about and an example of the SHOWCMD primary command.

The rules shown apply to substituting the slash ( / ) character for a data set name. Each rule is followed by one or more examples that prove the rule by using either a CLIST or a line command.

In each example, the data set being acted on is USER.TEST.DATA, which always appears, either completely or partially, in uppercase. However, the CLIST or line command is typed in lowercase to differentiate between the CLIST or line command and USER.TEST.DATA when this data set name is either completely or partially typed over.

Each example also shows:
Original
The line as it appears before the CLIST or line command is entered.
As typed
The line as it appears after the CLIST or line command is typed.
After
The line as it appears after the CLIST or line command is expanded to show the placement of quotes and data set name substitution for the slash (/) character.
  1. You can type over the data set name. Expanded commands can contain a maximum of 255 characters and are converted to uppercase. This example shows how rule 1 would apply if you typed %clist1 da(/):
    (Original)           USER.TEST.DATA
    (As typed)  %clist1 da(/).TEST.DATA
    (After)     %CLIST1 DA('USER.TEST.DATA')
  2. The data set name substitution character (/) is replaced with the quoted, fully qualified data set name if the character following the / is not a number, letter, or national character. This example shows how rule 2 would apply if you typed %clist2 / newdate(1986/03/15):
    (Original)           USER.TEST.DATA
    (As typed)  %clist2 / newdate(1986/03/15)
    (After)     %CLIST2 'USER.TEST.DATA' NEWDATE(1986/03/15)
  3. If a slash ( / ) is followed immediately by a member name in parentheses, the ending quote for the data set is placed after the closing parenthesis that follows the member name. This example shows how rule 3 would apply if you typed %clist3 da(/(xyz)):
    (Original)           USER.TEST.DATA
    (As typed)  %clist3 da(/(xyz)).DATA
    (After)     %CLIST3 DA('USER.TEST.DATA(XYZ)')
  4. If the first operand is the unquoted data set name as it appears in the list, quotes are added around it or after a closing parenthesis following a member name. This example shows how rule 4 would apply if you typed b (the B (browse) line command) and added member (abc):
    (Original)           USER.TEST.DATA
    (As typed)  b        USER.TEST.DATA(abc)
    (After)     B 'USER.TEST.DATA(ABC)'
  5. If the line command does not have any operands or if the data set name has not been substituted as specified by either rule 3 or rule 4, the quoted, fully qualified data set name is added to the end of the line command. This example shows how rule 5 would apply if you typed %clist4 user.test.fortran:
    (Original)           USER.TEST.DATA
    (As typed)  %clist4 user.test.fortran
    (After)     %CLIST4 USER.TEST.FORTRAN 'USER.TEST.DATA'
    This example shows how rule 5 would apply if you typed %clist4 'user.test.fortran'. The purpose of this example is to show that if you enclose the CLIST operand in quotes, ISPF still puts quotes around the data set name being acted on. The results are the same.
    (Original)           USER.TEST.DATA
    (As typed)  %clist4 'user.test.fortran'
    (After)     %CLIST4 'USER.TEST.FORTRAN' 'USER.TEST.DATA'
    This example shows how rule 5 would apply if you typed %clist5 member1(abc). The purpose of this example is to show that the results do not change if the CLIST operand contains a member name enclosed in parentheses.
    (Original)           USER.TEST.DATA
    (As typed)  %clist5 member1(abc)ATA
    (After)     %CLIST5 MEMBER1(ABC) 'USER.TEST.DATA'

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014