Function

To specify characteristics for one or more RJE workstations.

This command can be used to add BSC and SNA RJE workstations.

Not all parameters are applicable to each type of workstation. The parameter descriptions indicate applicability to each type and differences as appropriate. Parameters applicable to BSC-only and SNA-only workstations are listed here.

Most of the parameter specifications that can be changed on this command require that the RJE workstation be inactive. Issue the $D ACTRMT(nnnnn) command to obtain status of active RJE workstations before issuing the $T RMT(nnnnn) command.

Parameters

nnnnn

The subscript defining the RJE workstations affected by this command. The subscript may specify a 1- to 5-digit RJE workstation identifier or a range of identifiers as defined by an RMT(nnnnn) initialization statement. For information about specifying a range for this subscript, see Command syntax conventions.

Autolog={No|Yes}

For SNA RJE workstations only, specifies whether the SNA RJE workstation can be automatically connected (logged on) when output (print/punch) or messages are queued for transmission to the RJE workstation. The RJE workstation is allowed to log on only if:

• This command also specifies a logical unit name through the LUNAME= parameter on the corresponding RMTnn initialization statement.
• A JES2 line has been started and is available.
• The maximum number of sessions specified at initialization (with the SESSIONS parameter on the TPDEF statement) has not been exceeded.

BLOCK={No|Yes}

For BSC RJE workstations only, specifies whether this workstation has a blocked (YES) or unblocked (NO) data record format.

Note: You can change the value of this parameter only when the RJE workstation is inactive.

BUFEXPAN= {0|1|2}

For BSC 2770 RJE workstations only specifies whether this 2770 terminal has a buffer-expansion feature.

0

This terminal does not have the buffer-expansion feature.

1

This terminal has the buffer-expansion feature and implies an RJE workstation buffer of 264 bytes.

2

This terminal has the additional buffer-expansion feature and implies an RJE workstation buffer of 520 bytes.

Note:

1. You can change the value of this parameter only when the RJE workstation is inactive.
2. If an attached printer has a PRWIDTH= parameter greater than 120 bytes, specify BUFEXPAN=1 or 2.

BUFSIZE=bufsize

For BSC RJE workstations, specifies the largest buffer (127 to the BELOWBUF=(SIZE=) parameter value on the TPDEF initialization statement) that can be either sent from or received by this workstation.

BUFSIZE= enforces minimum buffer size specification based on device type for BSC RJE workstations.

For SNA RJE workstations, specifies the largest buffer (256 to the EXTBUF=(SIZE=) parameter value on the TPDEF initialization statement) that can be either sent from or received by this SNA RJE workstation.

The following table provides the minimum buffer size requirements for various RJE workstation types. If you specify a value less than that listed here, JES2 increases BUFSIZE= to this minimum value.

Table 1. JES2 BUFSIZE Minimum Buffer Size Requirements for RJE Workstations

Workstation	Type	BUFSIZE Value
SNA	N/A	256
Multileaving Terminals and Systems	N/A	MBUFSIZE= value on TPDEF statement
Hardware Terminal	2770 without buffer expansion (BUFEXPAN=0)	127
Hardware Terminal	2770 with buffer expansion (BUFEXPAN=1)	264
Hardware Terminal	2770 with additional buffer expansion (BUFEXPAN=2)	520
Hardware Terminal	2780	400
Hardware Terminal	3780	520
Hardware Terminal	3781	520

Note: You can change the value of this parameter only when the RJE workstation is inactive.

COMPACT={No|Yes}

For SNA RJE workstations only, specifies whether (YES) or not (NO) this RJE workstation or terminal allows JES2 to send a compaction table for use with a printer or punch data set.

Use the COMPACT initialization statement to define compaction tables. If more than one session is active and COMPACT=YES, all sessions are eligible to receive a compaction table.

Note: You can change the value of this parameter only when the RJE workstation is inactive.

COMPRESS={No|Yes}

Specifies whether (YES) or not (NO) this RJE workstation uses the compression/expansion feature.

For BSC RJE (2770 and 3780) workstations, if COMPRESS=YES is specified on both the LINE(nn) initialization statement and the remote device (print, punch, and reader) initialization statement (R(nn).XXm), the COMPRESS= parameter on this command determines whether JES2 uses the compression/expansion feature. If you specify COMPRESS=YES, JES2 forces HTABS=NO.

If COMPRESS=NO on the LINE(nn) statement, JES2 ignores this parameter.

For SNA RJE workstations, if COMPACT=YES is specified, JES2 forces compression.

Note: You can change the value of this parameter only when the RJE workstation is inactive.

CONDEST=condest

The route code (1 to the value of RMTNUM= on the TPDEF initialization statement) that is used for responses to commands entered from this RJE workstation. The value specified should be the number of a defined RJE workstation.

CONS={No|Yes}

Specifies whether (YES) or not (NO) this RJE workstation has an operator console or is simulating an operator console through the &PRTCONS RMT generation statement.

For SNA RJE workstations, you should specify this parameter only if the RJE workstation has an operator console.

If JES2 determines that this RJE workstation cannot have a console, it forces CONS=NO.

Note: You can change the value of this parameter only when the RJE workstation is inactive.

DEVTYPE={type}

Specifies the type of processor at this RJE workstation.

The following types apply:

LUTYPE1

For SNA RJE workstations, specifies that the workstation can be accessed only through a logical line. If DEVTYPE= is changed to a valid value other than LUTYPE1, this SNA remote workstation will be changed to a BSC remote workstations.

2770|2780|3780|3781

For BSC RJE workstations, specifies a hardware terminal.

2922|M20-2|M20-4|M20-5|M20-6

For BSC RJE workstations, specifies a multileaving workstation.

AS/400®|S/36|S/360|S/370|S/3

For BSC RJE workstations, specifies a system.

Note:

1. If you define a workstation that is not explicitly supported by JES2 but does emulate one of the types listed above, consult the documentation for that terminal so you set characteristics (such as buffer sizes) appropriately.
2. To ensure that punch output is directed to the proper device, specify ‘3781' to define remote 3780 terminals that contain punches.
3. You can change the value of this parameter only when the RJE workstation is inactive.
4. Changing this parameter to a different type (particularly between BSC and SNA types) causes certain restrictions on other parameters (such as BUFSIZE=). Review carefully all parameters to ensure that this command is valid. For further information concerning parameter requirements for the RMT(nn) statement, refer to z/OS JES2 Initialization and Tuning Reference, SA32-0992.

Discintv=discintv

For BSC RJE workstations, specifies the time interval in seconds (0 to 8160) after which, if there has been no successful text transmission in either direction, JES2 disconnects this RJE workstation from the processing unit.

For SNA RJE workstations, specifies the maximum interval in seconds (0 to 8160) after which, if there has been no successful text transmission in either direction, JES2 ends the session between the SNA RJE workstation and the processing unit.

• JES2 rounds this value to the next highest multiple of 32.
• 0 indicates that this terminal is not to be disconnected
• Error recovery tries and idle time do not count as successful text transmission.
• If automatic disconnect is not specified, the remote terminal remains connected until the operator signs it off.

HTABS={No|Yes}

For BSC RJE workstations only, specifies whether (YES) or not (NO) this 2770 or 2780 terminal has the horizontal format-control feature.

If you specify COMPRESS=YES, this parameter is forced to HTABS=NO.

Note: You can change the value of this parameter only when the RJE workstation is inactive.

LINE=line

Specifies the number (0-65535) of the teleprocessing (BSC) or logical (SNA) line that are both connected and dedicated to this terminal.

For BSC RJE workstations, if you specify LINE=0, JES2 provides a nondedicated RJE workstation, which can use any nondedicated BSC line that requires a /*SIGNON JCL statement to start.

For SNA RJE workstations, if you specify LINE=0, JES2 provides a nondedicated RJE workstation, which can use any nondedicated SNA line. If you specify LINE= as a value other than 0, you must also specify the UNIT=SNA parameter on the LINE(nn) initialization statement.

Note: You can change the value of this parameter only when the RJE workstation is inactive.

LOCAL190={ACTION|INFO}

Specifies the type of operator setup messages ($HASP190) that JES2 issues at the local processor console for this RJE workstation. If you do not specify this parameter, JES2 provides a default of ACTION.

ACTION

Specifies that operator setup messages issued at the local console for this remote device are action messages (messages that require an operator action to delete them from the console).

INFO

Specifies operator setup messages issued at the local console for this remote device as information messages (messages that do not require an operator action to delete them from the console).

LOGON=logon

Specifies the number (1-999) of the local LOGON DCT which should be used when specifying connections to the application. The default value of 0 indicates that the LOGON DCT defined with the lowest number is to be used.

LUNAME=luname

For SNA RJE workstations only, specifies the logical unit name of this RJE workstation or terminal. If you specify this parameter, it must match the name defined to VTAM® at system initialization in SYS1.VTAMLST.

If you use the automatic logon capability (Autolog=YES), you must specify an LUNAME= value. If the logical unit associated with the logical unit name is not the first of the terminal's logical units to logon to JES2, the LUNAME associated with the session comes from the name pointed to by the parameter list that VTAM passes to the JES2 logon exit.

Note: You can change the value of this parameter only when the RJE workstation is inactive.

MFORM={J|M|T}

For BSC RJE workstations only, specifies the amount of information to be displayed in JES2 remote console messages for this RJE workstation.

J

JES2 job-related messages including the jobname and job ID of the issuer.

M

JES2 job-related message text only.

T

JES2 job-related messages including a time stamp, the jobname, and job ID of the issuer.

MRF2780={No|Yes}

For BSC RJE workstations only, specifies whether (YES) or not (NO) this 2780 terminal has the multiple-record feature.

Note: You can change the value of this parameter only when the RJE workstation is inactive.

MSGPRT={No|Yes}

For BSC remotes, specifies whether (YES) or not (NO) JES2 prints messages routed to a printer attached to the console of an RJE workstation.

NO

Specifies that JES2 discards messages if the RJE workstation console is not available.

Specify NO if you would rather discard messages instead of printing them on the first available printer at the remote.

For BSC RJE workstations, this parameter only has meaning for an RJE workstation that does not have a console.

YES

Specifies that JES2 prints messages if the remote console is unavailable. For example, the remote console might not exist, be signed on, or have enough messages queued to it to exceed the RMTMSG= parameter on the TPDEF initialization statement.

For BSC RJE workstations, note that once a message is spooled for an RJE workstation, that message can only be printed; it cannot be displayed on an RJE workstation console.

MULTILV={No|Yes}

For BSC RJE workstations only, specifies whether (YES) or not (NO) this RJE workstation uses the BSC multileaving interfaces. If MULTILV=YES, you must specify a multileaving workstation. MULTILV=NO defines this RJE workstation as a BSC hardware terminal.

Note: You can change the value of this parameter only when the RJE workstation is inactive.

NUMPRt=numprt

Specifies the number (0-7) of printers (BSC) or logical printers (SNA) at this RJE workstation. JES2 provides the defaults specified on the R(nn).PR(m) initialization statement for new printers if NUMPRT= is increased.

Use the $T R(nn).PR(m) command to change any characteristics of each printer.

For BSC RJE workstations, JES2 can use values greater than 1 only when you specify MULTILV=YES. If you specify MULTILV=NO, JES2 uses a value of NUMPRT=1. A maximum total of eight printers and punches can be defined.

Note: If you specify this parameter as 0, JES2 resets it to 1.

For SNA RJE workstations, a maximum total of eight printers, punches, and a console can be specified. The maximum value for NUMPRT= is 6 if you also specify CONS=YES.

Specify NUMPRT=0 if you want no printers on this SNA RJE workstation.

Note:

1. You can change the value of this parameter only when the RJE workstation is inactive.
2. You must specify at least one device (printer, punch, reader, or SNA console) on the RMT definition.

NUMPUn=numpun

Specifies the number (0-7) of card punches (BSC) or logical card punches (SNA) at this RJE workstation or terminal. You must specify at least one device (printer, punch, reader, or SNA console) on the remote definition. JES2 provides the defaults specified on the R(nn).PU(m) initialization statement for new punches if NUMPUN= is increased. Then you can use the $T R(nn).PU(m) command to change any characteristics of each punch.

For BSC RJE workstations, a maximum total of eight printers and punches can be defined. If you specify MULTILV=NO and this parameter is specified greater than 1, JES2 uses only 1.

For SNA RJE workstations, a maximum total of eight printers, punches, and a console can be defined. SNA RJE workstations can support as many as seven punch data streams.

Note: You can change the value of this parameter only when the RJE workstation is inactive.

NUMRDr=numrdr

Specifies the number (0-7) of card readers (BSC) or logical card readers (SNA) at this RJE workstation or terminal. SNA RJE workstations can support as many as seven reader data streams. You must specify at least one device (printer, punch, reader, or SNA console) on the remote definition. JES2 provides the defaults specified on the R(nn).RD(m) initialization statement for new readers if NUMRDR= is increased. Then you can use the $T R(nn).RD(m) command to change any characteristics of each reader.

For BSC workstations, if you specify MULTILV=NO, this parameter is set to 1. If you set this parameter to 0, JES2 resets it to 1.

Note: You can change the value of this parameter only when the RJE workstation is inactive.

Password=password

The 1- to 8-character security password used to prevent unauthorized RJE workstation users from using the resources of this RJE workstation.

If you do not specify this parameter, JES2 provides no password. If you specify a null password (P=), JES2 deletes the previously assigned password.

Note: Be certain to make a note of those passwords assigned because there is no facility for displaying the passwords in effect.

RECFM={FIXED|VARIABLE}

For BSC RJE workstations only, specifies whether the data record for this terminal is fixed-length (FIXED) or variable-length (VARIABLE).

Note: You can change the value of this parameter only when the RJE workstation is inactive.

RMT150={No|Yes}

Specifies $HASP150 message routing as follows:

No

The $HASP150 message is sent only to the local operator.

Yes

If this RJE workstation has a console, the $HASP150 message is first sent to this console and then to the local operator.

Note:

1. For SYSTEM36 (S/36) terminals, if you specify CONS=YES, MULTILV=YES, and RMT150=YES, the remote printer pauses to ensure that the $HASP150 message arrives at the console before the data sets begin to print.
2. For SNA RJE workstations, this parameter is valid only if CONS=YES.
3. This parameter is not valid for hardware terminals.

Routecde=routecde

Specifies the route code (1 to 32767) assigned to this terminal and its associated printers, punches and readers. (However, you can specify one route code for the RJE workstation and different ones for the printers and punches to meet unique installation requirements.) If you do not assign a Routecde= value, JES2 assigns the number of this terminal (RMT(nn)) as its route code.

Note:

1. You can change the value of this parameter only when the RJE workstation is inactive.
2. If you are changing the value of this parameter to a value not equivalent to nn of RMT(nn), you must first complete the following steps:
   • Change the routing for all work from the previous RJE workstation routing to the new RJE workstation routing.
   • Determine if you need to change the Routecde= parameter for this RJE workstation's associated remote devices (printers, punches, readers, or console).

SETUP={MSG|PDIR}

For SNA RJE workstations only, specifies setup information as follows:

MSG

Specifies that JES2 must inform the remote operator of any setup requirements through the $HASP190 message. After setup is complete, the operator must enter a $S command to start JES2 transmission.

PDIR

Specifies that JES2 constructs and sends a peripheral data information record (PDIR) to the RJE workstation. The RJE workstation must process the data set header and generate any required messages. This setting allows spooling of data and generation of multiple copies of a data set at the RJE workstation.

Note: You can change the value of this parameter only when the RJE workstation is inactive.

SHARable|SHAREable={No|YES}

For BSC RJE workstations only, specifies whether (YES) or not (NO) JES2 allows the LINE= parameter value to be used by other RJE workstations. (If LINE=0, JES2 ignores this parameter.)

NO

Indicates that no other RJE workstations can specify and use the LINE= value and no /*SIGNON JCL statement is needed to start the remote.

YES

Indicates that multiple RMT definitions can also specify and use (share) the line specified on LINE= and a /*SIGNON JCL statement is required to start one of these RJE workstations.

Note:

1. You can change the value of this parameter only when the RJE workstation is inactive.
2. If you change the LINE= parameter specification and you do not specify this parameter, JES2 sets this parameter to SHARABLE=YES.

TRANSPAR={No|Yes}

For BSC RJE workstations only, specifies whether (YES) or not (NO) this RJE workstation has the text-transparency feature. To use this feature, you must also specify TRANSPAR=YES on the LINE(nn) initialization statement.

Note: You can change the value of this parameter only when the RJE workstation is inactive.

WAITIME=waitime

The length of time in seconds (0-30), that the RJE workstation access method (RTAM) should wait after completing the processing of any input stream, printed output stream, or punched output stream to allow the operator to enter an input stream at this RJE workstation.

For SNA RJE workstations, if WAITIME= is set too low (note the default of 1 second), contention might occur during SNA logon processing, which results in $HASP094 messages and the termination of the SNA session. Increase this parameter to allow the RJE workstation adequate time to respond during logon processing so that proper LU type 1 protocol is followed.

Authority Required

This command requires device authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires update security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

Single member. The values supplied for this command will be in effect for this member only.

Depending on your installation's setup, however, you might want this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP879 message displays the status of the specified remote device and its current characteristics.

JES2 sets the logical unit name of SNA RJE workstation 6 to ‘lu3770pc'.