Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
*ESCAPE Messages
Top |
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 |
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 |
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 |
Specifies the host subsystem type with which the session communicates.
The possible values are:
Top |
Specifies the type of communications line or protocol that is associated with this configuration.
The possible values are:
Top |
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 |
Specifies (for SNA only) whether the signon text is formatted.
The possible values are:
Top |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Specifies the record length of data that is received from the host and written to an output file.
The possible values are:
The maximum record length that RJE supports, including carriage-control characters, is 255 bytes. To ensure record alignment, the record length (page width) of the output file must be greater than or equal to the logical record length of the data that is received from the host subsystem.
Top |
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.
The possible values are:
Top |
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 |
Specifies the qualified name of the FCT associated with this session. To create the FCT, use the CRTFCT command.
The possible values are:
The possible library values are:
Top |
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 |
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 |
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 |
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 |
Specifies the controller associated with the host subsystem.
The possible values are:
Both the controller description and the line description must be created manually.
Top |
Specifies the type of physical interface on the input/output adapter port.
The possible values are:
Top |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Top |
*ESCAPE Messages
Top |