CHGS36SRCA (Change System/36 Source Attributes)

CHGS36SRCA Command syntax diagram

 

Purpose

The Change System/36 Source Attributes (CHGS36SRCA) command changes the attributes of the specified source member.

 

Required Parameters

MBR
Specifies the name of the source member whose attributes are being changed.

 

Optional Parameters

FILE
Specifies the qualified name of the source physical file that contains the source member.

The name of the physical file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

QS36SRC: The name of the default source physical file that contains the source member.

source-file-name: Specify the name of the source physical file that contains the source member.

SRCTYPE
Specifies the source type of the source member.

*SAME: The value does not change.

source-type: Specify the value for the source type of the member.

Value
Type of member
ARS36
Automatic response member
ASM36
Assembler member
BAS36
BASIC member
BASP36
BASIC procedure (source member)
BGC36
Business graphics utility chart member
BGD36
Business graphics utility data member
BGF36
Business graphics utility format member
CBL36
COBOL member
DFU36
Data file utility member
DSPF36
Display format member
DTA36
Data member
FOR36
FORTRAN member
MNU36
Menu member
MSGF36
Message member
PHL36
Phone list member
RPG36
RPG member
RPT36
RPG auto report member
SRT36
Sort member
WSU36
Work station utility member
UNS36
Unspecified

REFNBR
Specifies the reference number assigned to the source member.

*SAME: The value does not change.

*NEXT: The current reference number is increased by one. If the current reference number is 999,999, then the reference number returns to 0.

reference-number: Specify the reference number of the source member. Valid values range from 0 through 999,999.

RCDLEN
Specifies the logical record length of the statements in the source member (used by the Create System/36 Message File (CRTS36MSGF), Create System/36 Menu (CRTS36MNU), and Save System/36 Library Members (SAVS36LIBM) commands).

*SAME: The value does not change.

*FILE: The record length of the file specified by the FILE parameter is used.

record-length: Specify the logical record length of the statements in the member. Valid values range from 40 through 120 and must be less than or equal to the record length of the file.

MAXDEV
Specifies the maximum number of devices for a SFGR display file (used by the Create System/36 Display File (CRTS36DSPF) command).

*SAME: The value does not change.

number-of-devices: Specify the maximum number of devices for a source member. Valid values range from 1 through 256.

DFRWRT
Specifies that the writing of data to the display file is delayed until a read request is made. This parameter is used by the CRTS36DSPF (Create System/36 Display File) command when creating a display file from SFGR source located in this member. Control is returned to the requesting program immediately after the data is received for output. This may result in improved performance.

*SAME: The value does not change.

*YES: When a write request is made to the display file, control is returned after the buffer is processed. The data might not be shown immediately; the actual display of the data might take place later when a read or combined write/read operation is performed. The buffer is then available for the next read or combined write/read operation.

*NO: After a write operation to the display file, the entire input/output request is completed before returning control to the requesting program. All input/output feedback information will be available.

Examples for CHGS36SRCA

Example 1: Specifying Maximum Devices and Record Length

CHGS36SRCA  MBR(SFGRSRC)  FILE(SDALIB/QS36SRC)
  REFNBR(*NEXT)  RCDLEN(80)  MAXDEV(5)

This command changes source member SFGRSRC in file QS36SRC in library SDALIB to allow up to five devices and to have a record length of 80. It also increases the current reference number by one.

Example 2: Turning Off the Defer Write Attribute

CHGS36SRCA  MBR(SFGRSRC)  FILE(SDALIB/QS36SRC)
  REFNBR(*NEXT)  RCDLEN(80)  MAXDEV(5)  DFRWRT(*NO)

This command changes source member SFGRSRC in the file QS36SRC in library SDALIB to allow up to five devices and to have a record length of 80. It also increases the current reference number by one and turns off the defer write attribute.

Error messages for CHGS36SRCA

*ESCAPE Messages

CPF2C0A
Member &3 attributes not changed.
CPF2C0B
Changing attributes not allowed for SSP member &3.
CPF2C08
File &1 is not a source file.
CPF9803
Cannot allocate object &2 in library &3.
CPF9812
File &1 in library &2 not found.
CPF9815
Member &5 file &2 in library &3 not found.
CPF9820
Not authorized to use library &1.
CPF9822
Not authorized to file &1 in library &2.
CPF9826
Cannot allocate file &2.