Work Management APIs

The work management APIs perform functions that are used in a wide variety of applications. These APIs retrieve and manipulate:

• Jobs
• Subsystem storage pools
• Subsystem job queues
• Data areas
• Network attributes
• System status
• System values

The work management APIs are:

• Change Current Job (QWCCCJOB) changes information for the current job.
• Change Job (QWTCHGJB) changes some of the attributes of a job.
• Change Job Interrupt Status (QWCCJITP) retrieves and optionally modifies the job interrupt status of the current job.
• Change Job Pool (QWCCHGJP) moves a job into another main storage memory pool.
• Change Pool Attributes (QUSCHGPA) changes the size, activity level, and paging option of system storage pools.
• Change Pool Tuning Information (QWCCHGTN) changes information about tuning being performed on the system for the different storage pools.
• Change Pools (QWCCHGPL) changes how the system's memory is divided into storage pools.
• Change Processor Multitasking (QWCCHGPR) changes the processor multitasking information.
• Change Subsystem Entry (QWDCSBSE) changes a subsystem entry in the specified subsystem description.
• Control Thread (QTHMCTLT) holds, releases, or ends the specified thread.
• Create Job Structures (QWTCTJBS) creates the number of temporary job structures that are passed on the call.
• Delete Job Structures (QWTDTJBS) deletes the number of temporary job structures that are passed on the call to the API.
• List Active Subsystems (QWCLASBS) retrieves a list of active subsystems.
• List Job (QUSLJOB) lists some or all jobs on the system.
• List Job Schedule Entries (QWCLSCDE) lists the entries in the job schedule QDFTJOBSCD.
• List Object Locks (QWCLOBJL) generates a list of locks for an object or database file member. An object-level or member-level lock may be specified.
• List Subsystem Entries (QWDLSBSE) lists some of the different entries in a subsystem description, such as routing entries.
• List Subsystem Job Queues (QWDLSJBQ) lists the job queues for a subsystem.
• Move Job (QSPMOVJB) moves jobs from one position to another position within the same job queue or from one job queue to another job queue. Priority and status of the job are affected by the user's priority level and the status of the target job.
• Open List of Activation Attributes (QWVOLACT) generates a list of all the activation attributes that are associated with an activation group in a given job.
• Open List of Activation Group Attributes (QWVOLAGP) generates a list of all the activation groups that are associated with a given job and their attributes.
• Open List of Job Queues (QSPOLJBQ) generates a list of job queues on the system.
• Open List of Jobs (QGYOLJOB) generates a list of jobs on the system.
• Open List of Threads (QWCOLTHD) generates a list of active threads for the job specified in the Job identification parameter.
• Remove Pending Job Log (QWTRMVJL) changes a completed job whose job log has not yet been written.
• Retrieve Call Stack (QWVRCSTK) returns the call stack information for the specified thread.
• Retrieve Class Information (QWCRCLSI) returns the attributes of a class object.
• Retrieve Current Attributes (QWCRTVCA) retrieves specific attributes for the current thread.
• Retrieve Data Area (QWCRDTAA) retrieves the contents of a data area.
• Retrieve IPL Attributes (QWCRIPLA) returns the settings of options that are used during the IPL.
• Retrieve Job Description Information (QWDRJOBD) retrieves information from a job description object.
• Retrieve Job Information (QUSRJOBI) retrieves information, such as job attributes and performance data about a specific job.
• Retrieve Job Locks (QWCRJBLK) generates a list of objects that have been locked by the job or thread that is specified in the job identification information input parameter.
• Retrieve Job Queue Information (QSPRJOBQ) retrieves information associated with a specified job queue.
• Retrieve Job Status (QWCRJBST) returns status and job identification information about the job that is identified by the job identifier parameter.
• Retrieve Lock Information (QWCRLCKI) generates a list of information about lock holders of the item specified.
• Retrieve Lock Request Information (QWCRLRQI) takes as input a lock request handle that was returned in other APIs and returns information about the program that requested the lock.
• Retrieve Lock Space Attributes (QTRXRLSA) returns information for the specified lock space.
• Retrieve Lock Space Locks (QTRXRLSL) generates a list of objects that have been locked or that have lower level locks held by the specified lock space.
• Retrieve Lock Space Record Locks (QTRXRLRL) lets you generate a list of record locks held by the specified lock space.
• Retrieve Network Attributes (QWCRNETA) retrieves network attributes.
• Retrieve Processor Multitasking Information (QWCRTVPR) retrieves processor multitasking information.
• Retrieve Profile Exit Programs (QWTRTVPX) retrieves the profile exit flags that have been designated to be called for the specified user ID. The API then places that information into a single variable in the calling program.
• Retrieve Subsystem Information (QWDRSBSD) retrieves information about a specific subsystem.
• Retrieve Synchronization Object Information (Qp0msRtvSyncObjInfo()) retrieves status information for a synchronization object.
• Retrieve System Status (QWCRSSTS) retrieves a group of statistics that represent the current status of the system.
• Retrieve System Values (QWCRSVAL) retrieves system values.
• Retrieve Thread Attribute (QWTRTVTA) retrieves job and thread attributes that apply to the job or thread specified in the Job/Thread identification information parameter.
• Set Install Language (QINSTLNG) allows you to set the install language for the next operating system install.
• Set Profile Exit Programs (QWTSETPX) sets for the specified user ID the profile exit programs to call.

Several of the work management APIs work with job and thread attributes. Those job and thread attributes are discussed in Work Management API Attribute Descriptions.

The work management exit programs are:

• Auxiliary Storage Lower Limit (QIBM_QWC_QSTGLOWACN) is called when the available storage in the system auxiliary storage pool (ASP) goes below the lower limit.
• Call Job Interrupt Program (QIBM_QWC_JOBITPPGM) calls an exit program in the initial thread of a specified job.
• Job Notification (QIBM_QWT_JOBNOTIFY) logs notification messages to data queues when an i5/OS job starts, ends, or is placed on a job queue.
• Power Down System (QIBM_QWC_PWRDWNSYS) is called when the Power Down System (PWRDWNSYS) or End System (ENDSYS) command is used.
• Preattention Program (QIBM_QWT_PREATTNPGMS) is called when the user presses the System Attention key.
• Pre-Restricted State exit program (QIBM_QWC_PRERESTRICT) determines if a restricted state can be reached.
• Presystem Request Program (QIBM_QWT_SYSREQPGMS) is called when the user presses the System Request key.
• Resume System Exit Program (QIBM_QWC_RESUME) is called after the partition is resumed after migration or hibernation.
• Suspend System Exit Program (QIBM_QWC_SUSPEND) is called before the partition is to be temporarily suspended due to migration or hibernation.

[ Back to top | APIs by category ]