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
• Flight recorders

The work management APIs are:

• Call Job Interrupt Program (QWCJBITP) calls an exit program in the initial thread of a specified job 
• 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 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 Subsystem Entry (QWDCSBSE) changes a subsystem entry in the specified subsystem description.
• Control Thread (QTHMCTLT) holds, releases, or ends the specified thread.
• Control Trace (QWTCTLTR) turns the trace function on and off.
• 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.
• Dump Flight Recorder (QWTDMPFR) dumps the contents of the flight recorders for jobs that have them.
• Dump Lock Flight Recorder (QWTDMPLF) dumps the contents of the lock flight recorder for the device that is specified in the parameter that is passed to the program.
• 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 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 Lock Flight Recorder (QWTSETLF) turns the lock flight recorder on and off.
• Set Profile Exit Programs (QWTSETPX) sets for the specified user ID the profile exit programs to call.
• Set Trace (QWTSETTR) starts the Trace Job (TRCJOB) command for the job passed on the job and user name parameter at the earliest point while the job is starting.

The work management exit programs are:

• Auxiliary Storage Lower Limit is called when the available storage in the system auxiliary storage pool (ASP) goes below the lower limit.
• Call Job Interrupt Program is indirectly called by the Call Job Interrupt Program (QWCJBITP) API 
• Job Notification logs notification messages to data queues when an OS\/400 job starts, ends, or is placed on a job queue.
• Power Down System is called when the Power Down System (PWRDWNSYS) or End System (ENDSYS) command is used.
• Pre-Restricted State exit program determines if a restricted state can be reached.
• Preattention Program is called when the user presses the System Attention key.
• Presystem Request Program is called when the user presses the System Request key.