Change S/36 Environment Attr (CHGS36A)

Where allowed to run:
  • Batch job (*BATCH)
  • Interactive job (*INTERACT)
  • Batch program (*BPGM)
  • Interactive program (*IPGM)
  • Batch REXX procedure (*BREXX)
  • Interactive REXX procedure (*IREXX)
  • Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)
Threadsafe: No
Parameters
Examples
Error messages

The Change System/36 Attributes (CHGS36A) command allows the user to change the attributes of the System/36 environment configuration while the system is running in the System/36 environment.

More information about the System/36 environment is in the System/36 Environment Reference book.

Top

Parameters

Keyword Description Choices Notes
SLIB Default session library Name, *SAME Optional
FLIB Default files library Name, *SAME Optional
LIBL Use library list for file *YES, *NO, *SAME Optional
DATDIFF Date differentiated files *YES, *NO, *SAME Optional
S36ESHARE S/36 shared opens of files *YES, *NO, *SAME Optional
RCDBLK Shared file record blocking *YES, *NO, *SAME Optional
CACHEDLTF Store deleted files in cache *YES, *NO, *SAME Optional
LPPAGE Default lines per page 1-112, *SAME Optional
FORMTYPE Forms type Character value, *STD, *SAME Optional
DFTMSGACN Default message action *CONTINUE, *HALT, *IGNORE, *CANCEL, *SAME Optional
HALTOPT Halt options *SAME, 0, 1, 2, 3, 01, 02, 03, 012, 013, 123, 0123, 023, 12, 13, 23 Optional
EVKJOBINIT Evoke job initiation *IMMED, *JOBQ, *SAME Optional
EVKJOBPOL Evoke storage pool *BASE, *CURRENT, *SAME Optional
EVKJOBPTY Evoke job priority 1-99, *SUBMITTER, *SAME Optional
SRCRCDLEN Source file record length 52-132, *SAME Optional
CHGACT Allow CHGS36 while active *YES, *NO, *SAME Optional
ADDS36ONLY Add only S/36 users *YES, *NO, *SAME Optional
ICFSUBST Substitute ICF procedure data *YES, *NO, *SAME Optional
MRTUSRPRF MRT user profile *OWNER, *FRSTUSR, *SAME Optional
MRTAUT Check authority to files *ALLUSR, *FRSTUSR, *SAME Optional
MRTDLY MRT delay value 0-32767, *SAME Optional
MRTJOBINIT MRT job initiation *IMMED, *JOBQ, *SAME Optional
MRTJOBPOL MRT storage pool *BASE, *CURRENT, *SAME Optional
MRTJOBPTY MRT job priority 1-99, *SUBMITTER, *SAME Optional
Top

Default session library (SLIB)

Specifies the default session library name for users running jobs in the System/36 environment.

*SAME
The value does not change.
library-name
Specify the name of the default session library.
Top

Default files library (FLIB)

Specifies the default files library for users running jobs in the System/36 environment.

*SAME
The value does not change.
library-name
Specify the name of the default files library.
Top

Use library list for file (LIBL)

Specifies whether the library list is used when specifying database files for System/36 environment jobs.

*SAME
The value does not change.
*YES
The library list is used to search for database files.
*NO
The library list is not used to search for database files.
Top

Date differentiated files (DATDIFF)

Specifies whether jobs running in the System/36 environment can use files of the same name, distinguished by creation date.

*SAME
The value does not change.
*YES
Jobs can use files of the same name if the files have different creation dates.
*NO
Jobs cannot use files of the same name. Each file must have a unique name.
Top

S/36 shared opens of files (S36ESHARE)

Specifies whether the System/36 environment opens database files in a way to allow an open data path (ODP) to be shared by multiple programs processing in the same job.

*SAME
The value does not change.
*YES
Programs share an ODP to database files opened during the job. The shared files are held open between job steps.
*NO
Programs do not share an ODP to database files opened during the job. Files are closed between job steps.
Top

Shared file record blocking (RCDBLK)

Specifies whether the System/36 environment uses record blocking for sequential database files that share an ODP. More information about record blocking is in the Concepts and Programmers Guide for the System/36 Environment.

*SAME
The value does not change.
*YES
Jobs running use record blocking for shared sequential files.
*NO
Jobs running do not use record blocking for shared sequential files.
Top

Store deleted files in cache (CACHEDLTF)

Specifies whether database files deleted by the System/36 environment are stored in a cache.

*SAME
The value does not change.
*YES
The deleted files are stored in a cache.
*NO
The deleted files are not stored in a cache.
Top

Default lines per page (LPPAGE)

Specifies the default number of lines printed on a page for all printers for jobs running in the System/36 environment when no other number of lines is specified in the SET command or in the FORMS or PRINTER OCL statement.

*SAME
The value does not change.
lines-per-page
Specify the number of lines per page. Valid values range from 1 through 112.
Top

Forms type (FORMTYPE)

Specifies the form type of the default printer form which is used for System/36 printouts when no form type is specified in the SET command or in the FORMS or PRINTER OCL statement. The form types used to indicate different printer forms are user-defined and can be a maximum of 4 characters in length.

*SAME
The value does not change.
*STD
The standard form type is used.
form-type
Specify a user-defined form type.
Top

Default message action (DFTMSGACN)

Specifies the default action used for escape messages issued by CL commands in procedures running in the System/36 environment. The default action is used for messages not in the message list and when there is no message list. The default action is not used if the message list contains a message ID.

*SAME
The value does not change.
*CONTINUE
Processing continues with the next statement after the CL command. The ID of the escape message is saved and can be retrieved by the message ID substitution expression (?MSGID?).
*HALT
The procedure is stopped. Processing continues as specified on the Halt options (HALTOPT) parameter.
*IGNORE
The error is ignored and processing continues with the statement after the CL command. The ID of the escape message is not saved.
*CANCEL
The procedure is canceled.
Top

Halt options (HALTOPT)

Specifies a list of continuation options available when *HALT is specified for the default message action parameter. The list of options is a value consisting of up to 4 options with values ranging from 0 through 3, each of which represents an allowed response. If no options are specified, options 0 and 3 (value 03) are allowed. The meanings for the numbers assigned to the options are:

0
Continue. The message ID is saved for retrieval.
1
Retry the command. The message ID is not saved.
2
Cancel the job step. The message is saved for retrieval.
3
Cancel the job.
*SAME
The value does not change.
halt-options
Specify up to four continuation options. Multiple options must be specified in ascending order and each option must be unique. Each digit must be the character 0, 1, 2, or 3 (blanks are ignored).
Top

Evoke job initiation (EVKJOBINIT)

Specifies how EVOKE jobs or job steps are started within the System/36 environment.

*SAME
The value does not change.
*IMMED
The job queue is bypassed when starting jobs.
*JOBQ
Jobs are started from the job queue.
Top

Evoke storage pool (EVKJOBPOL)

Specifies the storage pool used for an EVOKE job that bypassed the job queue when starting to run in the System/36 environment.

*SAME
The value does not change.
*BASE
The job uses the subsystem's base pool storage area.
*CURRENT
The job uses the same storage pool as the submitting job.
Top

Evoke job priority (EVKJOBPTY)

Specifies the priority level at which an EVOKE job in the System/36 environment must be started when it bypasses the job queue.

*SAME
The value does not change.
*SUBMITTER
The job is started with the same run priority as the submitting job.
1-99
Specify a priority level.
Top

Source file record length (SRCRCDLEN)

Specifies the record length in bytes for System/36 source files QS36PRC and QS36SRC. These source files are created by System/36 environment utilities.

*SAME
The value does not change.
record-length
Specify the source file record length. Valid values range from 40 through 120 bytes (not including the extra 12 bytes required for the source sequence and date fields of each record).
Top

Allow CHGS36 while active (CHGACT)

Specifies whether the configuration object can be updated using the Change System/36 (CHGS36) command while others are signed on to the System/36 environment.

*SAME
The value does not change.
*YES
The configuration information can be changed with the CHGS36 command while others are signed on to the System/36 environment.
*NO
The configuration information cannot be changed with the CHGS36 command while others are signed on to the System/36 environment.
Top

Add only S/36 users (ADDS36ONLY)

Specifies whether a workstation device can be added to the System/36 environment configuration when the device signs on to the System/36 environment.

*SAME
The value does not change.
*YES
A workstation device is added to the configuration only when that device signs on to the System/36 environment.
*NO
A workstation device is added to the configuration when that device is created, not when it signs on to the System/36 environment.
Top

Substitute ICF procedure data (ICFSUBST)

Specifies if data received on an intersystem communications function (ICF) start request is scanned for substitution expressions.

*SAME
The value does not change.
*YES
The data received on an ICF start request is scanned for substitution expressions, unless it is an ICF start request from a retail device or a finance device.
*NO
The data received on an ICF start request is not scanned for substitution expressions. This value can be preferable if the data may contain question marks that should not be treated as substitution expressions.
Top

MRT user profile (MRTUSRPRF)

Specifies the user profile under which the Multiple Requester Terminal (MRT) program runs to check security in the System/36 environment.

*SAME
The value does not change.
*OWNER
The MRT program runs under the profile of the MRT program owner.
*FRSTUSR
The MRT program runs under the profile of the user that starts the program.
Top

Check authority to files (MRTAUT)

Specifies which users are checked for their authority to obtain access to files used by the MRT program in the System/36 environment.

*SAME
The value does not change.
*ALLUSR
All users are checked for their authority to obtain access to the files.
*FRSTUSR
Only users who start MRT programs are checked for their authority to obtain access to the files.
Top

MRT delay value (MRTDLY)

Specifies the time (in seconds) that the system delays (waits) before ending the MRT program in the System/36 environment. The specified value is not valid if the program is a never-ending program (NEP).

*SAME
The value does not change.
seconds-to-wait
Specify the number of seconds the system waits before ending the program. Valid values range from 0 to 32767 seconds.
Top

MRT job initiation (MRTJOBINIT)

Specifies how an MRT job is started in the System/36 environment.

*SAME
The value does not change.
*IMMED
The job queue is bypassed when starting the job.
*JOBQ
The job is started from the job queue.
Top

MRT storage pool (MRTJOBPOL)

Specifies the storage pool used for an MRT job started without using the job queue in the System/36 environment.

*SAME
The value does not change.
*BASE
The job uses the subsystem's base pool storage area.
*CURRENT
The job uses the same storage pool as the submitting job.
Top

MRT job priority (MRTJOBPTY)

Specifies the priority level for starting an MRT job that bypasses the job queue.

*SAME
The value does not change.
*SUBMITTER
The job starts with the same priority level as the submitting job.
priority-level
Specify the priority level for starting the job. Valid values range from 1 through 99.
Top

Examples

CHGS36A   FLIB(MYLIB)  CACHEDLTF(*YES)  LPPAGE(66)

This command changes the value of the default files library to MYLIB for users running jobs in the System/36 environment. Storage for deleted files is changed to a cache. The number of lines printed on a page is changed to 66.

Top

Error messages

None

Top