Function

To add one or more RJE workstations. You cannot use this command to add an RJE workstation with a number higher than that either previously defined by RMTNUM= on the TPDEF initialization statement or the highest numbered RJE workstation defined by RMT(nnnnn) initialization statements.

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.

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 RMTnnnn 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.

BUFEXPAN= {0|1|2}

For BSC 2770 RJE workstations only, specifies whether this 2770 terminal has a buffer-expansion feature. If you do not specify a value, JES2 provides no buffer expansion.

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: 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.

If you do not specify this parameter, JES2 provides the following defaults for the following device types:

Table 1. JES2 BUFSIZE Defaults 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

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.

COMPRESS={No|Yes}

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

For BSC RJE (2770 and 3780) workstations, specifies if COMPRESS=YES is specified on both the LINE(nnnn) initialization statement and the remote device (print, punch, and reader) initialization statement (R(nnnn).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(nnnn) statement, JES2 ignores this parameter.

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

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 remote workstation cannot have a console, it forces CONS=NO.

If you do not specify this parameter, JES2 provides a default of CONS=NO. The CONS=NO value does not stop JES2 from sending data destined to a console.

DEVTYPE=type

Specifies the type of processor at this RJE workstation. If this parameter is not specified, terminal type 2770 (BSC workstation) is used.

The following types apply:

LUTYPE1

For SNA RJE workstations, specifies that the workstation can be accessed only through a logical line. (This is the only valid SNA specification for DEVTYPE=.)

2770|2780|3740|3780|3781

For BSC RJE workstations, specifies a hardware terminal.

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

For BSC RJE workstations, specifies a multileaving workstation.

AS400|AS/400®|SYSTEM36|SYSTEM/36| S/36|S360|S/360|S370|S/370|SYSTEM3|SYSTEM/3|S/3

For BSC RJE workstations, specify 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. Specify a 3740 hardware terminal as a 2780.
3. To ensure that punch output is directed to the proper device, specify ‘3781' to define remote 3780 terminals that contain punches.

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.

LINE=line

Specifies the number (0-65535) of the teleprocessing (BSC) or logical (SNA) lines 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. A /*SIGNON JCL statement is required to start the RJE workstation.

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(nnnn) initialization statement.

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 starting a JES2-initiated session with this SNA remote (autologon or $S RMT). The default value of 0 indicates that LOGON2 is to be used unless it is not defined, in which case the lowest numbered logon 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.

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.

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.

MSGPRT={No|Yes}

For BSC RJE workstations, 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.

NUMPRt=numprt

Specifies the number (0-7) of printers (BSC) or logical printers (SNA) at this RJE workstation or terminal. JES2 provides the defaults specified on the R(nnnn).PR(m) initialization statement.

Use the $T R(nnnn).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.

For SNA RJE workstations, a maximum total of eight printers, punches, and a console can be specified. You must specify at least one device on the RMT(nnnn) definition.

If you do not specify a value, JES2 provides a default of NUMPRT=1. Specify NUMPRT=0 if you want no printers on this RJE workstation or terminal.

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, or reader) on the remote definition. JES2 provides the defaults specified on the R(nnnn).PU(m) initialization statement. Then you can use the $T R(nnnn).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 reader data streams.

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, or reader) on the remote definition. JES2 provides the defaults specified on the R(nnnn).RD(m) initialization statement. Then you can use the $T R(nnnn).RD(m) command to change any characteristics of each reader.

If you do not specify a value, JES2 provides a default of NUMRDR=1.

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.

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).

RMT150={No|Yes}

Specifies $HASP150 message routing as follows:

Y

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

N

The $HASP150 message is sent only 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. Refer to the DEVTYPE= parameter for a list of valid hardware terminal types for SNA RJE workstations.

Routecde=routecde

Specifies the route code (1 to 32767) assigned to this terminal and its associated printers, punches and readers. If you do not assign a Routecde= value, JES2 assigns the number of this terminal (RMT(nnnn)) as its route code.

New output created can take advantage of this route code immediately but existing output might require the $R command to be selected by this destination.

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.

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.

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(nnnn) initialization statement.

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 control 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.

Messages

The $HASP879 message displays the status of the specified RJE workstation.