Create Class (CRTCLS)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Class command creates a class object and specifies the attributes to be contained in the class. The class defines the processing attributes for jobs that use the class. The class used by a job is specified in the subsystem description routing entry used to start the job. If a job consists of multiple routing steps, the class used by each subsequent routing step is specified in the routing entry used to start the routing step.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CLS | Class | Qualified object name | Required, Positional 1 |
| Qualifier 1: Class | Name | ||
| Qualifier 2: Library | Name, *CURLIB | ||
| RUNPTY | Run priority | 1-99, 50 | Optional |
| TIMESLICE | Time slice | 0-9999999, 2000 | Optional |
| PURGE | Eligible for purge | *YES, *NO | Optional |
| DFTWAIT | Default wait time | 0-9999999, 30, *NOMAX | Optional |
| CPUTIME | Maximum CPU time | 1-9999999, *NOMAX | Optional |
| MAXTMPSTG | Maximum temporary storage | 1-2147483647, *NOMAX | Optional |
| MAXTHD | Maximum threads | 1-32767, *NOMAX | Optional |
| TEXT | Text 'description' | Character value, *BLANK | Optional |
| AUT | Authority | Name, *LIBCRTAUT, *CHANGE, *ALL, *USE, *EXCLUDE | Optional |
| Top |
Class (CLS)
Specifies the name and library used for the class name.
This is a required parameter.
Qualifier 1: Class
- name
- Specify the name of the class.
Qualifier 2: Library
- *CURLIB
- The class is created in the current library for the thread. If no library is specified as the current library for the thread, the QGPL library is used.
- name
- Specify the library where the class is created.
| Top |
Run priority (RUNPTY)
Specifies the run priority of jobs that use the class. Run priority is a value ranging from 1 (highest priority) through 99 (lowest priority) that represents the priority at which the job competes for the processing unit relative to other jobs that are active at the same time. For multi-threaded jobs, the run priority is also the highest run priority allowed for any thread within the job. Individual threads within the job may have a lower priority.
This value represents the relative, not absolute, importance of the job. For example, a job with a run priority of 25 is not twice as important as one with a run priority of 50.
- 50
- Jobs that use this class have a run priority of 50.
- 1-99
- Specify the run priority of jobs using this class.
| Top |
Time slice (TIMESLICE)
Specifies the maximum amount of processor time (in milliseconds) given to each thread in a job using this class before other threads in a job or other jobs are given the opportunity to run. The time slice establishes the amount of time needed by a thread in a job to accomplish a meaningful amount of processing. At the end of the time slice, the thread might be put in an inactive state so that other threads can become active in the storage pool.
- 2000
- A maximum run time of 2000 milliseconds is allocated to each thread each time it is allowed to process.
- 0-9999999
- Specify the maximum amount of time (in milliseconds) that each thread in a job using this class can have to run when it is given processing time.
Note: Although you can specify a value of less than 8, the system takes a minimum of 8 milliseconds to run a process. If you display a job's run attributes, the time slice value is never less than 8.
| Top |
Eligible for purge (PURGE)
Specifies whether the job is eligible to be moved out of main storage and put into auxiliary storage at the end of a time slice or when there is a long wait (such as waiting for a work station user's response). The operating system no longer uses this parameter.
- *YES
- The job is eligible to be moved out of main storage and into auxiliary storage. However, a job with multiple threads is never purged from main storage.
- *NO
- The job is not eligible to be moved out of main storage and put into auxiliary storage. However, when main storage is needed, pages belonging to a thread in this job may be moved to auxiliary storage. Then, when a thread in this job runs again, its pages are returned to main storage as they are needed.
| Top |
Default wait time (DFTWAIT)
Specifies the default maximum time (in seconds) that a thread in the job waits for a system instruction, such as the LOCK machine interface (MI) instruction, to acquire a resource. This default wait time is used when a wait time is not otherwise specified for a given situation. Normally, this would be the amount of time the system user would be willing to wait for the system before the request is ended. If the wait time for any one instruction is exceeded, an error message can be displayed or it can be automatically handled by a Monitor Message (MONMSG) command.
- 30
- An instruction wait has a maximum of 30 seconds in which to complete.
- *NOMAX
- There is no maximum wait time.
- 0-9999999
- Specify the maximum time (in seconds) that the system waits for an instruction to acquire a resource.
| Top |
Maximum CPU time (CPUTIME)
Specifies the maximum processing unit time (in milliseconds) that the job can use. If the job consists of multiple routing steps, each routing step is allowed to use this amount of processing unit time. If the maximum time is exceeded, the job is held.
- *NOMAX
- There is no limit on the processing unit time used.
- 1-9999999
- Specify the maximum amount of processing unit time (in milliseconds) that can be used.
| Top |
Maximum temporary storage (MAXTMPSTG)
Specifies the maximum amount of temporary (auxiliary) storage (in megabytes) that the job can use. If the job consists of multiple routing steps, this is the maximum temporary storage that the routing step can use. This temporary storage is used for storage required by the program itself and by implicitly created internal system objects used to support the job. It does not include storage for objects in the QTEMP library. If the maximum temporary storage is exceeded, the job is held. This parameter does not apply to the use of permanent storage, which is controlled through the user profile.
- *NOMAX
- The system maximum is used.
- 1-2147483647
- Specify the maximum amount of temporary storage (in megabytes) that can be used.
| Top |
Maximum threads (MAXTHD)
Specifies the maximum number of threads that a job using this class can run with at any time. If multiple threads are initiated simultaneously, this value may be exceeded. If this maximum value is exceeded, the excess threads will be allowed to run to their normal completion. Initiation of additional threads will be inhibited until the maximum number of threads in the job drops below this maximum value.
- *NOMAX
- There is no maximum number of threads.
- 1-32767
- Specify the maximum number of threads for a job.
Note: Depending upon the resources used by the threads and the resources available on the system, the initiation of additional threads may be inhibited before this maximum value is reached.
| Top |
Text 'description' (TEXT)
Specifies the text that briefly describes the object.
- *BLANK
- No text is specified.
- 'description'
- Specify no more than 50 characters of text, enclosed in apostrophes.
| Top |
Authority (AUT)
Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
- *LIBCRTAUT
- The authority for the object is taken from the value specified for the Create authority (CRTAUT) parameter of the library in which the object is being created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
- *CHANGE
- The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
- *ALL
- The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
- *USE
- The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
- *EXCLUDE
- The user cannot access the object.
- name
- Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
| Top |
Examples
CRTCLS CLS(CLASS1) RUNPTY(60) TIMESLICE(900)
TEXT('This class for all batch jobs from Dept 4836')
This command creates a class called CLASS1. The class is stored in the current library specified for the job. The user text 'This class for all batch jobs from Dept 4836' describes the class. The attributes of this class provide a run priority of 60 and a time slice of 900 milliseconds. If the job has not finished running at the end of a time slice, it is eligible to be moved out of main storage until it is allocated another time slice. The defaults for the other parameters are assumed.
| Top |
Error messages
*ESCAPE Messages
- CPF1027
- No authority to library &1.
- CPF1039
- Class library &1 not found.
- CPF1064
- Class &1 exists in library &2.
- CPF1067
- Cannot allocate library &1.
- CPF9802
- Not authorized to object &2 in &3.
- CPF9899
- Error occurred during processing of command.
| Top |