z/OS TSO/E Command Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Control section tags

z/OS TSO/E Command Reference
SA32-0975-00

Use the beginning of the NAMES data set to control certain operations of the TRANSMIT and RECEIVE commands. The tags are optional. You can include any of the following tags:
:ALTCTL.dsname
specifies the fully-qualified file name of another file to be used in the nickname look up process. If TRANSMIT finds more than one :ALTCTL tag, TRANSMIT uses the order of the :ALTCTL tags to scan the files. You can specify up to ten :ALTCTL tags. All control section tags, the :LOG and :NOLOG tags, the :LOGNAME tag, and the :NOTIFY and :NONOTIFY tags are always ignored when read from any alternate NAMES data set.
:EPILOG.text
in the control section, specifies a text line to be appended at the end of any transmitted message. The maximum length of an epilog line is 72 characters. You can specify up to ten :EPILOG lines. If more than one :EPILOG record is found, records appear in the message in the same order as they are in the file. Text data for the :EPILOG tag must be on the same line as the :EPILOG tag.
:PROLOG.text
in the control section, specifies a text line to be inserted at the beginning of any transmitted message. The maximum length of a prolog line is 72 characters. You can specify up to ten :PROLOG lines. If more than one :PROLOG record is found, records appear in the message in the same order as they are in the NAMES data set. Text data for the :PROLOG tag must be on the same line as the :PROLOG tag.
:LOGNAME.name
in the control section, serves as a default qualifier for the log data set name. If you specify it in the nickname entry, the value provided overrides the default set in the control section. See Logging function of TRANSMIT and RECEIVE.
:LOGSEL.name
in the control section, specifies the second (middle) qualifier of all log data sets. See Logging function of TRANSMIT and RECEIVE.
:LOG | :NOLOG
in the control section, indicates whether you want logging for any addressee specified by node and user ID and for any nickname that does not also specify :LOG or :NOLOG. If the nickname entry contains the :LOG or :NOLOG tag, this value overrides any value in the control section. However, it might have been overridden by a specification on the TRANSMIT command. If you specify NOLOG in your NAMES data set in the control section or on a :NICK tag, TSO/E prompts you with a message to receive data set ‘PREFIX.MAIL.USERID’. TSO/E then stores and places the message in ‘myid.MAIL.USERID’ where myid is the receiver of the message and USERID is the originator of the message.

The default is :NOLOG.

:NOTIFY | :NONOTIFY
in the control section, indicates whether you want notification for any addressee specified by node and user ID, and for any nickname where the nickname entry does not contain :NOTIFY or :NONOTIFY. The value of :NOTIFY or :NONOTIFY in the NAMES data set might be overridden by a similar specification on the TRANSMIT command. If you want to be notified for addressees on distribution lists, you must specify :NOTIFY on the distribution list in the control data set or specify NOTIFY(ALL).

The default is :NOTIFY.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014