Script Dataset Allocation (0.6)
Related topics
The Script Data set Allocation screen (0.6) is used to define the allocation parameters for the system and user script data sets. These data sets are accessed when the CAPTURE or INCLUDE primary commands are used to record or execute a script. The data set to use field allows you to choose which script data set Code Debug will search for the specified script member when an INCLUDE command is executed. The data set chosen is also the one in which script members created with the CAPTURE command will be saved. If Code Debug has been installed with access to user-defined user script data sets, additional fields are available to define their attributes. If you use the CAPTURE command to create a script, these attributes are used to allocate the data set before the script is saved. Values entered on this screen are saved in the profile data set.
Access this screen by typing the number 6 on the Session Profile Menu, or as described in Transferring Between Screens.
Script Data set Allocation Screen (0.6)
COMMAND ===>
MODULE: CSECT:
System Dataset Name..... ACME.XPED.SYSTEM.SCRIPT
User Dataset Prefix.....
Suffix..... MYUSRID.SCRIPT.DATASET
Dataset to use.......... U S (System) U (user)
Start capture at session initiation? NO
Save script if CAPTURE ON at session termination? YES If YES save as: MYUSRID
Attributes To Apply If New User Dataset Is Allocated:
Allocate SMS dataset.... NO
Yes (SMS) No (Non-SMS) Volume Serial......
Space Units........ BLK (CYL,TRK BLK)
Management Class... Primary............ 10
Storage Class...... Secondary.......... 5
Data Class......... Directory Blocks... 10
Library............ NO Block Size......... 32760 (0 | Mult of 120)
Yes (PDSE) No (PDS) Unit............... SYSDA
Input Fields
Global Parameters Used to Initialize Defaults
The input fields on the Script Data set Allocation screen are initialized based on the values of the Code Debug CICS global parameters listed in the folloiwng table. For a complete description of Code Debug’s global parameters, see Code Debug CICS Advanced Configuration space.
Code Debug Global Parameters for Script Data set Allocation Screen
Script Data set Allocation | Global Parameter |
|---|---|
User Data set Suffix | SCRIPT_FACILITY_USER_SCRIPT_DSN |
Data set to use | SCRIPT_FACILITY_USER_SCRIPT_ENABLE |
Save script if CAPTURE ON | SCRIPT_FACILITY_SESS_TERMINATION_STATUS |
If YES save as | SCRIPT_FACILITY_SAVE_AS_NAME |
Allocate SMS data set | SCRIPT_FACILITY_USER_SCRIPT_SMS |
Management Class | SCRIPT_FACILITY_USER_SCRIPT_MGMT_CLASS |
Storage Class | SCRIPT_FACILITY_USER_SCRIPT_STG_CLASS |
Data Class | SCRIPT_FACILITY_USER_SCRIPT_CLASS |
Library | SCRIPT_FACILITY_USER_SCRIPT_LIBRARY |
Volume Serial | SCRIPT_FACILITY_USER_SCRIPT_VOLUME |
Space Units | SCRIPT_FACILITY_USER_SCRIPT_TYPE |
Primary | SCRIPT_FACILITY_USER_SCRIPT_PRIMARY_ALLO |
Secondary | SCRIPT_FACILITY_USER_SCRIPT_SECOND_ALLO |
Directory Blocks | SCRIPT_FACILITY_USER_SCRIPT_DIR_BLOCKS |
Block Size | SCRIPT_FACILITY_USER_SCRIPT_BLKSIZE |
Unit | SCRIPT_FACILITY_USER_SCRIPT_UNIT |
User Data set Suffix
The suffix of the user script data set name. Valid values are 1- to 44-character user script data set names. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_DSN. The entire user script data set name, including the value in the Prefix field, cannot be more than 44 characters in length.
Data set to use
Specifies whether Code Debug is to search only the system script data set when the INCLUDE primary command is entered, or search the user script data set first, then the system script data set. Valid values are U for user and S for system. If user script data sets are enabled, the default value, which can be changed on this screen, is U. Otherwise, the default value is S.
Start capture at session initiation?
Specifies whether a script capture should be started when Code Debug CICS is first entered. Valid values are YES and NO. When YES is specified, Code Debug CICS always attempts to begin capturing data from the start of the session, preventing the loss of possibly valuable data. Allocation errors because of insufficient space or other system problems cause an error message to display on the initial Code Debug CICS screen. When NO is specified, the CAPTURE ON primary command can still be used later in the session to manually start capturing.
Save script if CAPTURE ON at session termination?
Specifies whether Code Debug is to save a script or discard it if the capture process is active when a debugging session is terminated. Valid values are YES and NO. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_SESS_TERMINATION_STATUS.
If YES save as
The name of the script data set member in which to save a script being captured when a debugging session is terminated. Valid values are 1- to 8-character member names. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_SAVE_AS_NAME.
Attributes To Apply If New User Data set Is Allocated Area:
Allocate SMS data set
Specifies whether IBM’s Storage Management Subsystem (SMS) is to be used when dynamically allocating user script data sets. Valid values are YES and NO. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_SMS.
Management Class
Specifies the SMS management class for dynamically allocated user script data sets. This field is only available if the Allocate SMS data set field is set to YES. Valid values are 1- to 8-character management classes. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_MGMT_CLASS.
Storage Class
Specifies the SMS storage class for dynamically allocated user script data sets. This field is only available if the Allocate SMS data set field is set to YES. Valid values are 1- to 8-character storage classes. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_STG_CLASS.
Data Class
Specifies the SMS data class for dynamically allocated user script data sets. This field is only available if the Allocate SMS data set field is set to YES. Valid values are 1- to 8-character data classes. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_CLASS.
Library
Specifies the type of SMS data set, either PDS or PDSE, to be used for dynamically allocated user script data sets. This field is only available if the Allocate SMS data set field is set to YES. Valid values are YES for PDSE and NO for PDS. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_LIBRARY.
Volume Serial
Specifies the volume serial number for dynamically allocated user script data sets. This field is only available if the Allocate SMS data set field is set to NO. Valid values are 1- to 6-character volume serial numbers. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_VOLUME.
Space Units
Specifies the space units for dynamically allocated user script data sets. This field is only available if the Allocate SMS data set field is set to NO. Valid values are TRK for tracks, BLK for blocks, and CYL for cylinders. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_TYPE.
Primary
Specifies the primary allocation size, in the designated space units, for dynamically allocated user script data sets. This field is only available if the Allocate SMS data set field is set to NO. Valid values are 1 to 8,388,607. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_PRIMARY_ALLO.
Secondary
Specifies the secondary allocation size, in the designated space units, for dynamically allocated user script data sets. This field is only available if the Allocate SMS data set field is set to NO. Valid values are 1 to 8,388,607. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_SECOND_ALLO.
Directory Blocks
Specifies the number of directory blocks to be used for dynamically allocated user script data sets. This field is only available if the Allocate SMS data set field is set to NO. Valid values are 1 to 8,388,607. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_DIR_BLOCKS.
Block Size
Specifies the size of directory blocks to be used for dynamically allocated user script data sets. This field is only available if the Allocate SMS data set field is set to NO. Valid values are 0 to 32760 and must be evenly divisible by 120. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_BLKSIZE.
Unit
Specifies the unit name for dynamically allocated user script data sets. This field is only available if the Allocate SMS data set field is set to NO. Valid values are 1- to 8-character unit names. The default value, which can be changed on this screen, is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_UNIT.
Output Fields
System Data set Name
The name of the system script data set. The value is set with the global parameter SCRIPT_FACILITY_SYSTEM_SCRIPT_DSN.
User Data set Prefix
The prefix of the user script data set name. The value is set with the global parameter SCRIPT_FACILITY_USER_SCRIPT_DSN_PREFIX. The CICS region must be authorized by your site’s external security manager — RACF for example — to create data sets with the prefix specified in this field.