# 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 the next message.
`*` | text | Displays the comment.

Copyright © TIBCO Software Inc. All rights reserved.