Rendezvous Generic Sender or Listener

The SXR3GEN program is in USERHLQ.LOAD.

The JCL sample is as follows:
  • Data Set: USERHLQ.JCL
  • Member: SXRGENSL

    Before using this utility, you must specify the Rendezvous transport parameters, for example:

    //SET IVPNETW='-network 127.0.0.1 -service 7555'

    //SXRGEN EXEC PGM=SXR3GEN,PARM='&IVPNETW'

SYSIN Parameters

The commands or messages sent by the utility are determined by the keywords and operands in the SYSIN DD Name file. See the following table.

Rendezvous Generic Sender or Listener Control Parameters
Keyword Operand Description
DEBUG |DBG OFF|ON Enables debug facility messages. It is recommended that you retain the default (OFF) unless TIBCO Support requires the output.
DEST-RECV subject name Specifies the subject name to receive the message reply. Overrides DEST-RECV-DEFAULT in a group.
DEST-RECV-DEFAULT subject name Specifies the default subject name if DEST-RECV is not specified. The default is tibss.admin.sxs.reply.
DEST-SEND subject name Specifies the subject name to which messages are sent. Overrides DEST-SEND-DEFAULT in a group.
DEST-SEND-DEFAULT subject name Specifies the default subject name if DEST-SEND is not specified. The default is tibss.admin.sxs.request.
END Denotes the end of the keywords for a message command definition, sometimes referred to as a group.
FLD type, name, value Defines a field for the message.

Where:

type is I32, U32, PST, or STR.

name is the name of the mapped field.

value is the data to be associated with the field.

The message can contain multiple fields.

PSWD password Specifies the password for the user ID previously specified and authorized to execute this command or process. This keyword is Security Interface dependent and is for the tibss-password system field. The default is blank.
PUBLISH-ONLY Specifies that the utility only sends messages and does not wait or receive any messages. Be sure to specify a DEST-RECV parameter so that the published message has a reply-to field.
REPEAT number Specifies the number of times to send this message. The default is 1.
TIMEOUT number Specifies the time (in seconds) to wait for the response message. The permitted range is 0 to 60 seconds. The default is 5.
UFLD-PFX prefix Specifies the prefix for all Substation ES system field names. The default is tibss-. It is recommended that you do not change this value for IVP runs.
USER userid Specifies the RACF or back-end user ID for the user who is authorized to execute this command or process. This keyword is Security Interface dependent and is for the tibss-userid system field. The default is a blank.
WAIT timevalue Specifies the time (in seconds) to wait between message or command sends. The default is 0. This is the interval a delay occurs after an END keyword is detected.

The time to delay between each message group is determined by the value of WAIT plus the value of WAIT-ON-REPEAT.

WAIT-ON-REPEAT timevalue Specifies the time (in seconds) to wait after each send of the command that is being repeated. The default is 0.

0 is a special value that means the next message must be published as soon as the current response (or TIMEOUT) occurs.

For non-zero values, the process uses this value minus the response time of the previous message (or TIMEOUT). If the calculation is greater than zero, then the process waits for that amount of time before publishing next message.

* text Displays the comment.
  • Examples
    The section provides the examples related to the Substation ES commands.