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.