Change RJE Writer Entry (CHGRJEWTRE)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
Change RJE Writer Entry
The CHGRJEWTRE command changes attributes in an existing session description writer entry. The change takes effect when the STRRJEWTR command is issued for this entry.
Error messages for CHGRJEWTRE
*ESCAPE Messages
- RJE0017
- &1 was not found in session description &2.
- RJE0024
- Errors found. Processing of request ended.
- RJE0067
- No members were found in file &1 in &2.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SSND | RJE session description | Qualified object name | Required, Positional 1 |
| Qualifier 1: RJE session description | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| WTR | RJE writer identification | PR1, PR2, PR3, PR4, PR5, PR6, PR7, PR8, PR9, PR10, PR11, PR12, PR13, PR14, PR15, PU1, PU2, PU3, PU4, PU5, PU6, PU7, PU8, PU9, PU10, PU11, PU12, PU13, PU14, PU15 | Required, Positional 2 |
| FILE | Output file | Single values: *SAME Other values: Qualified object name |
Optional, Positional 3 |
| Qualifier 1: Output file | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| MBR | Member | Name, *SAME, *GEN, *FIRST | Optional, Positional 4 |
| SPLFNAME | BSC Spooled file name | *SAME, *DEVFNAME, *JOBNAME | Optional |
| FSN | File member sequence number | 0-999, *SAME | Optional |
| FORMTYPE | Host form type | Character value, *SAME, *STD | Optional |
| DTAFMT | Data format | *SAME, *FCFC, *DATA, *CMN | Optional |
| PGM | Program to call | Single values: *SAME, *NONE Other values: Qualified object name |
Optional |
| Qualifier 1: Program to call | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| MSGQ | Message queue | Single values: *SAME, *NONE Other values: Qualified object name |
Optional |
| Qualifier 1: Message queue | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB |
| Top |
RJE Session Desc (SSND)
Specifies the qualified name of the session description that contains the writer entry being changed.
The possible library values are:
- *LIBL: The library list for the job is used to locate the session description.
- *CURLIB: The current library for the job is used to locate the session description. If no current library is specified, QGPL is used.
- library-name: Specify the name of the library where the session description is located.
session-description-name: Specify the name of the session description being changed.
| Top |
RJE Writer ID (WTR)
Specifies the writer entry being changed.
The possible values are:
- PR1 - PR15: A value between PR1 and PR15 is used.
- PU1 - PU15: A value between PU1 and PU15 is used.
| Top |
Output File (FILE)
Specifies the qualified name of the file that receives the data from the host subsystem.
The possible values are:
- *SAME: The file name in the session-description writer entry does not change.
The possible library values are:
- *LIBL: The library list for the job is used to locate the file.
- *CURLIB: The current library for the job is used to locate the file. If no current library is specified, QGPL is used.
- library-name: Specify the name of the library where the file is located.
- file-name: Specify the name of the diskette, DDM, physical, printer, or source physical file that receives the data from the host subsystem. Diskette and printer files must be program described.
| Top |
Member (MBR)
Specifies the file member to which output is directed. This parameter applies only if a DDM, physical, or source physical file is specified in the FILE parameter.
The possible values are:
- *SAME: The member name in the session-description writer entry does not change.
- *GEN: Creates a member name formatted as either Affffffccc or Bffffffccc where:
- A
- Indicates that the file member contains print data.
- B
- Indicates that the file member contains punch data.
- ffffff
- Up to the first six non-blank characters of the form type that was received from the host subsystem. Only A through Z, 0 through 9, $, #, @, and _ are valid in the form type that is used to generate member names.
- ccc
- A three-digit FSN controlled by the session to maintain member uniqueness.
If a member name already exists in the file, the three-digit sequence number is incremented by one until a unique name is reached and a member is created, or until sequence numbers up to and including 999 have been tried without creating a member.
If no member is created, the writer issues a message requesting you to either try again or to cancel this file.
- *FIRST: The first member in the file is used.
- member-name: Specify the name of the file member. If the member does not exist, an inquiry message is sent to the RJE message queue.
| 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 found in the peripheral data set information record (PDIR) sent from the host subsystem.
The possible values are:
- *SAME: The spooled file member name in the session description writer entry does not change.
- *DEVFNAME: The spooled file name is the same as the printer file name.
- *JOBNAME: The spooled file name is the same as the job name received in the job name message of the BSC host subsystem.
| Top |
File Member Seq Number (FSN)
Specifies the initial three-digit FSN that is used to create member names. This parameter applies only if *GEN is specified for the MBR parameter.
The possible values are:
- *SAME: The FSN in the session-description writer entry does not change.
- file-sequence-number: Specify the initial three-digit FSN. Leading zeros are not required for FSNs less than 100.
| Top |
Host Form Type (FORMTYPE)
Specifies the initial form type used if no form-mount message is received from the host subsystem.
The possible values are:
- *SAME: The initial form type in the session-description writer entry does not change.
- *STD: The initial form type used is *STD.
- form-type: Specify the initial form type. Valid entries range from one to eight alphanumeric characters in length.
| Top |
Data Format (DTAFMT)
Specifies the format of the output data.
The possible values are:
- *SAME: The format in the session-description writer entry does not change.
- *FCFC: The output data is in first-character forms control (FCFC) format. If DEVTYPE(*PUN) is specified, *FCFC is invalid.
The data can be written to a physical file in FCFC format and printed later using the Copy File (CPYF) command, specifying an FCFC printer file for the TOFILE parameter. The record length of the physical file must include one extra byte for the FCFC code.
- *DATA: The output data is in data format. No FCFC codes are embedded in the data. Specify *DATA to send data to a physical file to be processed by a program.
- *CMN: The output data is in communications format (256-character records). *CMN format decreases communications time. Before using the data, issue the CVTRJEDTA command to convert it to either FCFC format or data format. If you specify *CMN, the output file must be a physical file with a record length of 256 bytes.
| Top |
Program to Call (PGM)
Specifies the qualified name of a user program associated with the session description.
The possible values are:
- *SAME: The user program name in the session-description writer entry does not change.
- *NONE: No user program is associated with the writer.
The possible library values are:
- *LIBL: The library list for the job is used to locate the user program.
- *CURLIB: The current library for the job is used to locate the user program. If no current library is specified, QGPL is used.
- library-name: Specify the name of the library where the user program is located.
- program-name: Specify the name of the user program associated with the session description.
| Top |
Message Queue (MSGQ)
Specifies the qualified name of the message queue to which messages for the writer are sent.
The possible values are:
- *SAME: The message queue in the session-description writer entry does not change.
- *NONE: A message queue is not used.
The possible library values are:
- *LIBL: The library list for the job is used to locate the message queue.
- *CURLIB: The current library for the job is used to locate the message queue. If no current library is specified, QGPL is used.
- library-name: Specify the name of the library where the message queue is located.
- message-queue-name: Specify the name of the message queue.
| Top |
Examples
None| Top |
Error messages
*ESCAPE Messages
- RJE0017
- &1 was not found in session description &2.
- RJE0024
- Errors found. Processing of request ended.
- RJE0067
- No members were found in file &1 in &2.
| Top |