HFS File Name Considerations

When HFS file names contain internal Connect:Direct® for z/OS® keywords, single quote delimiters are required. For example, coding:

DSN=/u/myspace/DCB/test.file

would be rejected at submit time because DCB is an internal Connect:Direct for z/OS keyword that requires an equal sign.

Surrounding the entire file name within single quotes resolves this issue unless variable substitution is being used. If a Connect:Direct for z/OS keyword is being used along with variable substitution, then a more complex syntax is required. For example, coding:

                SYMBOL &FILE="file"
                  :
                DSN=/u/myspace/ -
                    'DCB/' -
                    test.&FILE

would produce:

DSN='/u/myspace/DCB/test.file'

All Connect:Direct for z/OS keywords used in DSN= or FILE= should be treated in this manner.

The following is a list of keywords that must receive special consideration if contained in an HFS file name:

ALIAS AVGREC BLKSIZE BUFND CASE CKPT CLASS
COMPRESS COPY CRC DATACLAS DATAEXIT DATATYPE DCB
DEBUG DISP DSN DSNTYPE DSORG ESF EXCLUDE
FOLD FROM HOLD IOEXIT JOB KEYLEN KEYOFF
LABEL LIKE LIMCT LRECL MGMTCLAS MVSGP NCP
NETMAP NEWNAME NODE NOREPLACE NOTIFY OPTCD PACCT
PARM PDS.DIR PDS.DIRECTORY PGM PNODE PNODEID PRECOMP
PRINT REQUEUE RESGDG RETAIN RKP RUN SACCT
SECMODEL SELECT SIGNON SNODE SPACE SQL STORCLAS
STRIP.BLANKS SUB SUBMIT SUBNODE SYSOPTS TASK TMPDD
TMPDSN TO TODAY TOMORROW TRTCH TYPE UNIT
USERID VOL VOLSER WHERE XLATE