Create RJE Configuration (CRTRJECFG)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

Create RJE Configuration

The CRTRJECFG command creates the following objects, which are necessary for operating a session in a specific environment:

A configuration must be created for each environment (host subsystem or line type).

If you decide not to use this command, you can use other CL commands to create these objects individually.

Error messages for CRTRJECFG

*ESCAPE Messages

RJE0013
RJE configuration for session &1 was not created.
RJE5303
Create RJE Configuration (CRTRJECFG) command was canceled.
Top

Parameters

Keyword Description Choices Notes
SSN Session Name, QRJE Optional, Positional 1
CFGLIB Configuration library Name, QRJE Optional, Positional 4
TYPE Host system type *JES2, *JES3, *RSCS, *PWR, *RES Optional, Positional 5
LINTYP Communication line type *BSC, *SDLCS, *X25, *LAN Optional
LOGON Host signon/logon command Character value, *NONE, *PROMPT Optional, Positional 2
FORMATTED Formatted SNA logon *NO, *YES Optional, Positional 3
RJERDRS Number of readers 0-15, 3 Optional
RJEPRTS Number of printers 0-15, 3 Optional
RJEPUNS Number of punches 0-15, 3 Optional
USRDTA User data *PRTF, *SYSDATE Optional
SEPFILE Separate files *NO, *YES Optional
SPLFNAME BSC Spooled file name *DEVFNAME, *JOBNAME Optional
BLKLEN Block length 1-8192 Optional
OUTRCDLEN Output record length *FIXED, *FILE Optional
TRNSPY Send as transparent data *NO, *YES Optional
DTACPR Compress output data *NO, *YES Optional
FCT Forms control table Single values: *NONE
Other values: Qualified object name
Optional
Qualifier 1: Forms control table Name
Qualifier 2: Library Name, *LIBL, *CURLIB
OUTQ Output queue Qualified object name Optional
Qualifier 1: Output queue Name, QPRINT
Qualifier 2: Library Name, *LIBL, *CURLIB
RSRCNAME Resource name Name, LIN011 Optional
CFGID Configuration identifier Character value, 01 Optional
DEV Devices Values (up to 46 repetitions): Name, *GEN Optional
CTL Controller description Name, *GEN Optional
INTERFACE Physical interface *RS232V24, *V35, *X21, *X21BISV24, *X21BISV35 Optional
CNN Connection type *MP, *NONSWTPP, *SWTPP Optional
LINESPEED Linespeed 600, 1200, 2400, 4800, 7200, 9600, 14400, 19200, 48000, 56000, 57600, 64000 Optional
SNBU Switched network backup *NO, *YES Optional
NRZI NRZI decoding *NO, *YES Optional
DUPLEX Duplex *FULL, *HALF Optional
MODEM Modem *NORMAL, *V54, *IBMWRAP, *IBMLPDA1, *IBMLPDA2 Optional
UNITADR Unit address list in hex Values (up to 46 repetitions): Character value, *GEN Optional
STNADR Station address Character value Optional
SSCPID SSCP identifier Character value Optional
EXCHID Exchange identifier in hex Character value, *SYSGEN Optional
MAXFRAME Maximum frame size 265, 521, 1033, 2057 Optional
CNNNBR Switched connection number Character value, *NONE Optional
RMTID Remote identifier Character value, *NONE, *ANY, *NOID Optional
AUTODIAL Automatic dialing feature *NO, *YES Optional
AUTOANS Automatic answer feature *NO, *YES Optional
DIALCMD Dial command type *NONE, *V25BIS Optional
AUTOCALL Autocall unit *NO, *YES Optional
ACRSRCNAME Autocall resource name Name Optional
Top

Session (SSN)

Specifies the session name associated with the configuration being created. The name specified is also the name of the session description, subsystem description, and message queue.

The possible values are:

Top

Configuration Lib (CFGLIB)

Specifies the name of the configuration library that stores the RJE configuration objects (other than the line, controller, and device descriptions) being created.

The possible values are:

Top

Host System Type (TYPE)

Specifies the host subsystem type with which the session communicates.

The possible values are:

Top

Communication Line Type (LINTYPE)

Specifies the type of communications line or protocol that is associated with this configuration.

The possible values are:

Top

Host Logon Command (LOGON)

Specifies the signon (logon) value the host subsystem receives from the server system.

Note: For formatted logons, this value must equal the value expected at the host subsystem.

The possible values are:

Note: Apostrophes are not needed if the prompt is used to enter the text.

Top

Format SNA Logon (FORMATTED)

Specifies (for SNA only) whether the signon text is formatted.

The possible values are:

Top

Number of Readers (RJERDRS)

Specifies the number of readers supported by the session.

For LINTYP(*BSC), a device description, BSC file, and job queue are created for each reader. Associated reader and communications entries are added to the session description.

For LINTYP(*SDLCS), LINTYP(*LAN), and LINTYP(*X25), a job queue is created for each reader. Associated reader entries are added to the session description. Unless the number of readers specified is 0, a job queue and a reader entry provide the automatic reader function for either SDLC or BSC.

The possible values are:

Top

Number of Printers (RJEPRTS)

Specifies the number of printers supported by the session.

For LINTYP(*BSC), a device description, a BSC file, and an output printer file are created for each printer. Associated writer and communications entries are added to the session description.

For LINTYP(*SDLCS), LINTYP(*LAN), and LINTYP(*X25), an output printer file is created for each printer. Associated writer entries are added to the session description.

The possible values are:

Top

Number of Punches (RJEPUNS)

Specifies the number of punches supported by the session.

For LINTYP(*BSC), a device description, a BSC file, and an output physical file are created for each punch device. Associated writer and communications entries are added to the session description.

For LINTYP(*SDLCS), LINTYP(*LAN), and LINTYP(*X25), an output physical file is created for each punch device. Associated writer entries are added to the session description.

The possible values are:

Top

User Data (USRDATA)

Specifies whether the user data field of the printer spooled file is overwritten with the two-byte configuration identifier plus the current system date stamp.

The possible values are:

Top

Separate Files (SEPFILE)

Specifies whether jobs with multiple data sets have separate output files created for them when they specify the same form type and number of copies.

This parameter will affect output directed to any of the destinations that RJE supports:

Some host subsystems send a PDIR before every data set; others send one at the beginning of the job, and after that only if the following data set has setup changes. Subsystems that support PDIRs before each data set are MVS/SP JES2 and MVS/SP JES3, the latter only if PDIR=ALL is specified on the device statement for the SNA workstation definition.

This parameter applies only to SNA sessions.

The possible values are:

If your host subsystem does not fully support PDIRs, specifying *YES or *NO for this parameter has no effect. (The OS/VS1 RES and VSE/POWER subsystems do not fully support PDIRs.)

Top

BSC Spooled File (SPLFNAME)

Specifies the name of the spooled file for printer or punch device output. This parameter applies only to BSC sessions.

Note: SNA sessions use the job name in the peripheral data set information record (PDIR) sent from the host subsystem.

The possible values are:

Top

Block Length (BLKLEN)

Specifies the maximum block length (in bytes) of the data being sent and received.

For LINTYP(*BSC), the default block length is 400, but a block length up to 8192 can be specified. The value specified must equal the block length specified for the host subsystem.

For LINTYP(*SDLCS) and LINTYP(*X25), the default block length is 256, but any block length up to 4096 that is a multiple of 256 can be specified. The value specified is the same as the request/response unit (RU) size specified at the host subsystem, and it is used on the MAXLENRU parameter in the CRTDEVHOST command. The BLKLEN parameter on the CRTRJECMNF command is assigned the value (*CALC).

Top

Output Rcd Lngth (OUTRCDLEN)

Specifies the record length of data that is received from the host and written to an output file.

The possible values are:

Top

Snd as Transparent (TRNSPY)

Specifies (for BSC only) whether text transparency is used to send blocked records. Text transparency allows all 256 EBCDIC character codes to be sent. This is used to transmit packed or binary data fields. The value must equal the value specified for the host subsystem.

  1. ASCII text transparency is not supported by the operating system.
  2. Transparency of received data is determined by the data stream; therefore, this parameter does not apply to received data.

The possible values are:

Top

Compress Output (DTACPR)

For BSC only, specifies whether data compression is performed.

Note: The value must be the same as the value specified for the host subsystem. For SNA, data compression is controlled by the bind request sent by the host subsystem.

The possible values are:

Top

Forms Cntrl Table (FCT)

Specifies the qualified name of the FCT associated with this session. To create the FCT, use the CRTFCT command.

The possible values are:

Top

Output Queue (OUTQ)

Specifies the qualified name of the output queue that contains output being sent to the printer. The output queue name is the queue name for the job description and printer files created as a result of this command.

Only one set of RJE job descriptions is created in a configuration library. The first RJE configuration created in a library specifies an output queue. Additional configurations in the library use the existing job descriptions and their output queues. Use the Create Output Queue (CRTOUTQ) command to create an output queue.

The possible library values are:

The possible values are:

Top

Resource Name (RSRCNAME)

Specifies the resource name that identifies the hardware that the description represents. Use the Work with Hardware Resources (WRKHDWRSC) command to determine the resource name.

The resource name consists of the input/output adapter (IOA) resource name and the port number on the IOA. For example, if the resource name of the IOA is LIN01 and the port on the IOA is 2, then the resource name would be LIN012.

Top

Configuration ID (CFGID)

Specifies the two-character identifier that is used to name RJE objects associated with this configuration. This value must be unique because all line, controller, and device descriptions are stored in the QSYS library.

The possible values are:

Note: The only special characters you can use are: @, #, $.

Top

Devices (DEV)

Specifies the device description objects associated with the host subsystem and this configuration.

The possible values are:

The BSC devices must be specified in the proper order to appear correctly in the session description display. The proper entry order is the input console, the output console, the printers, the punches, and then the readers.

To create a device description for a device to use with the host subsystem, use the Create Device Description (SNA Host) (CRTDEVHOST) command for SNA devices, and the Create Device Description (BSC) (CRTDEVBSC) command for BSC devices.

Top

Controller Description (CTL)

Specifies the controller associated with the host subsystem.

The possible values are:

Top

Phys Interface (INTERFACE)

Specifies the type of physical interface on the input/output adapter port.

The possible values are:

Top

Connection Type (CNN)

Specifies the type of line connection used.

Note: This parameter applies only if *GEN was specified on the DEV and CTL parameters.

The possible values are:

Top

Linespeed (LINESPEED)

Specifies the line speed in bits per second (bps).

The possible values are:

Values greater than 19200 cannot be used with the RS-232/V.24 interface.

Top

Switched Ntwk Backup (SNBU)

Specifies, for controllers attached to nonswitched lines only, whether the switched network backup (SNBU) feature is activated or deactivated. This feature lets you bypass a broken nonswitched connection by establishing a switched connection. This parameter applies only if SWITCHED(*NO) and SNBU(*YES) were specified when the controller description was created.

Note: *GEN must be specified on the DEV and CTL parameters.

The possible values are:

Top

NRZI Decoding (NRZI)

Specifies whether non-return-to-zero-inverted (NRZI) data encoding is used for modems that are sensitive to certain bit patterns in the data stream. This ensures that the signal does not stay the same for an extended period of time. This parameter applies only if *GEN is specified on the DEV and CTL parameters and *SDLCS is specified on the LINTYP parameter.

Note: All data communications equipment on the line must use the same transmission method.

The possible values are:

If the field is left blank, the keyword NRZI is not applicable.

Top

Duplex (DUPLEX)

Specifies whether request-to-send (RTS) is set on permanently (for full-duplex modems) or only when transmission is required (for half-duplex modems).

Note: This parameter applies only if *GEN is specified on the DEV and CTL parameters.

The possible values are:

Top

Modem (MODEM)

Specifies the type of modem that supports the communications line. This parameter applies only if *GEN is specified on the DEV and CTL parameters.

Refer to the modem manual for the appropriate value to select.

The possible values are:

Top

Unit Address List (UNITADR)

Specifies the unit address of the device associated with the host subsystem for the LU-(logical unit)-to-LU communications in an SNA communications environment. The number of LUs supported depends on the limitations of the host subsystem. This parameter applies only if DEV(*GEN) and SNA line types are specified.

A device description and communications file are created for each unit address. Associated communications entries are added to the session description.

Note: To minimize interruptions during processing, the number of LUs should be the sum of the number of readers (specified by the RJERDRS parameter), printers (RJEPRTS), and punches (RJEPUNS), plus one. Direct-workstation input is accepted only if there are at least two idle LUs.

The possible values are:

Top

Station Address (STNADR)

Specifies, for LINTYP(*SDLCS), DEV(*GEN), and CTL(*GEN) only, the station address to which the local system responds when polled by the host system if it answers a call. It has a two-digit hexadecimal value between 01 and FE.

Top

SSCP Identifier (SSCPID)

Specifies the system service control point (SSCP) identifier of the host subsystem. This applies only when LINTYP(*SDLCS), DEV(*GEN), and CTL(*GEN) are specified.

Note: The SSCP identifier is a 12-digit hexadecimal value, in which the first two digits are hex 05.

Top

Exchange ID (EXCHID)

Specifies the hexadecimal exchange identifier that is used to identify the local system to the remote system. The eight-digit hexadecimal exchange identifier contains three digits for the block number and five digits for the identifier of this system. This applies only when LINTYP(*SDLCS), DEV(*GEN), and CTL(*GEN) are specified.

The possible values are:

Top

Max Frame Size (MAXFRAME)

Specifies the maximum frame (path information unit (PIU)) size that the controller can send or receive. This value is used to calculate request unit (RU) sizes. Because the maximum PIU size that the controller can send or receive is negotiated at exchange identifier time, the maximum PIU size used at run time may be different. This value matches the corresponding value on the host subsystem. This applies only when LINTYP(*SDLCS), DEV(*GEN), and CTL(*GEN) are specified.

maximum-frame-size: Specify one of the following values for the maximum frame size for this controller:

Top

Switched Connection (CNNNBR)

Specifies, for switched lines, the telephone number used to establish a switched connection on this line description. This parameter value is sent to the automatic call unit if automatic calling is used to establish a switched connection, or it is sent to the V.25 bis modem if V.25 bis automatic dialing is used to establish the connection. When manual dialing is used to establish a switched connection on the line, this number is displayed to the system operator. For X.25, this number is the remote DTE address for the SVC provided by the X.25 network. This applies only when DEV(*GEN) and CTL(*GEN) are specified.

The possible values are:

Top

Remote ID (RMTID)

Specifies, for CTL(*GEN) and DEV(*GEN) only, a list of identifiers for remote BSC controllers. This parameter applies only to switched lines. It is required if SWITCHED(*YES) or SNBU(*YES) is specified.

The possible values are:

Top

Automatic Dial (AUTODIAL)

Specifies, for CTL(*GEN) and DEV(*GEN) only, whether the automatic dialing feature is installed. This feature automatically dials the telephone number of the modem that connects the host subsystem to the server system station. AUTODIAL(*YES) is used only if CNN(*SWTPP) or SNBU(*YES) is specified.

The possible values are:

Top

Automatic Answer (AUTOANS)

Specifies, for CTL(*GEN) and DEV(*GEN) only, whether the automatic answer modem feature is installed. This feature allows incoming calls on the line to connect automatically to communications equipment. AUTOANS(*YES) is used only if CNN(*SWTPP) or SNBU(*YES) is specified.

The possible values are:

Top

Dial Command Type (DIALCMD)

Specifies, for CTL(*GEN) and DEV(*GEN) only, the type of dial command used to establish a connection with a remote system.

The possible values are:

Top

Autocall Unit (AUTOCALL)

Specifies, for CTL(*GEN) and DEV(*GEN) and for switched lines or switched network backup lines, whether the line has an associated automatic call unit that performs automatic calling to the remote system.

The possible values are:

Top

Autocall Rsrce (ACRSRCNAME)

Specifies, for CTL(*GEN) and DEV(*GEN) only, the resource name that describes the automatic call unit port. The resource name consists of the input/output adapter (IOA) resource name and the port number on the IOA. For example, if the resource name of the IOA is LIN02 and the port is 1, the resource name is LIN021.

Top

Examples

None
Top

Error messages

*ESCAPE Messages

RJE0013
RJE configuration for session &1 was not created.
RJE5303
Create RJE Configuration (CRTRJECFG) command was canceled.
Top