>>-BUFFER--=--+-buffer_address------------------+-------------->< +-(--buffer_address--,--LUNAME--)-+ '-(--buffer_address--,--SCAN--)---'
macroinstructions: | USSMSG |
dependencies: | TEXT, OPT, SUPP, terminal operator messages |
The message text defined in the storage area must follow the rules listed in Syntax rules for messages.
The message text is sent to the terminal operator as it appears in the storage area. VTAM® does not modify or translate the message text (even if FEATUR2=LOWERCSE is specified for the device). You are responsible for including any device-dependent control characters within the message.
'@@LUNAME IS NOW IN SESSION WITH VTAM, @@@@DATE'
the
message received at the terminal would look like the following information:
'TERMA IS NOW IN SESSION WITH VTAM, 01/04/94'
Character string | In message text | Format |
---|---|---|
@@@@DATE | Current Date | In the format and with the delimiter specified in the DATEFRM and DATEDLM operands on the USSTAB macroinstruction. |
@HOSTNET | NETID from Start Options | The network ID is left-aligned and trailing blanks are inserted, if the network ID is fewer than eight characters. |
@...@ZONEID | Client IPv6 zone ID | If the IPv6 zone ID exists, it will be included. |
@...@IPADD | Client IP Address | 39 bytes, leading zeros suppressed, left justified,
with trailing blanks if needed. If the IP address type is IPv4 then it will be in dotted-decimal format. If the IP address type is IPv6 it will be in colon–hexadecimal format. |
@...@IPHOSTNAME* | DNS Name of client | Name left justified with trailing blanks if fewer than 40 characters in length. |
@@LUNAME | Terminal name | The name is left-aligned and trailing blanks are inserted, if the name is fewer than eight characters. |
@@@NETID | Network ID | The network ID is left-aligned and
trailing blanks are inserted, if the network ID is fewer than eight
characters. The network identifier for a nonnative-network-attached terminal is the real network name (the network identifier of the network where the terminal resides), not the name of the network it is attached to. |
@@@@@@@@@@@@@@NQN | Network-qualified name | The network-qualified name is left-aligned and trailing blanks are inserted if the network-qualified name is fewer than 17 characters, as networkID.name. |
@@PRT | Client Port Address | Five bytes and leading zeros are not suppressed. |
@@@@RUNAME | Request/response unit | The name of the request or response
unit is left-aligned and trailing blanks are inserted, if the RU name
is less than ten characters. Applies only to USSMSG07 when coded using the BUFFER operand. |
@@@SENSE | Sense code | Eight-character sense code. Applies only to USSMSG07 when coded using the BUFFER operand. |
@@SSCPNM | SSCPNAME from Start Options | The SSCP name is left-aligned and trailing blanks are inserted, if the SSCP name is fewer than 8 characters. |
@@@@TIME | Current Time | As HH_MM_SS, where an underscore (_) is the delimiter specified on the TIMEDLM operand of the USSTAB macroinstruction. |
*IPHOSTNAME must be preceded by 40 @ symbols.
The USS message length field contains the length of the USS message text only (do not include the length of the 2-byte length field in the calculation of the message length).
The following assembler statements show a popular method which can be used to define a USS message and the corresponding buffer when the BUFFER= operand is used:
MSG10 DC AL2(MSG10E-MSG10S) * Msg length (2 byte field)
MSG10S EQU * * Start of USS message
DC C'Place up to 65535 bytes of USS message text here'
MSG10E EQU * * End of USS message