z/OS JES2 Macros
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


$#TJEV – Manage the thread JOE exclusion vector

z/OS JES2 Macros
SA32-0996-00

Use $#TJEV to manage the thread JOE exclusion vector. There are at most one of these vectors for each SAPID. The vector provides a means for an application to state that a given data set should be kept, but never shown to the keeping thread again.

Format description

Read syntax diagramSkip visual syntax diagram
>>-+--------+--$#TJEV------------------------------------------->
   '-symbol-'           

>--FUNC=--+-ADD--SAPID=--address---+--JOE=--address------------><
          +-MOVE--NEWJOE=--address-+                  
          +-PURGE------------------+                  
          '-|  |-------------------'                  

Search Service

|--+-SEARCH SAPID=--address-+--+----------------------+--+-------------------------+--|
   '-(SEARCH,ANY)-----------'  '-FOUND=--+-address--+-'  '-NOTFOUND=--+-address--+-'   
                                         '-register-'                 '-register-'     

FUNC=
Specifies the service being requested.
ADD
Use the JOE address and SAPID address provided to turn on the bit representing the given JOE in the TJEV pointed to by the SAPID. If no TJEV exists for the SAPID, create one and turn on the bit.
SEARCH
Use the JOE and SAPID addresses provided to see if the JOE is excluded from the selection by the thread. FOUND= and NOTFOUND= are used to branch to the appropriate logic point.
SEARCH,ANY
Use the JOE address provided and examine all TJEVs in the system to see if any of them has the bit turned on for the JOE provided. FOUND= and NOTFOUND= are used to branch to the appropriate logic point.
PURGE
Use the JOE address provided and examine all TJEVs in the system. Ensure all TJEVs have the bit turned off that represents the JOE.
MOVE
Use the JOE= and NEWJOE= addresses provided to move the TJEV setting for the JOE to the setting for the NEWJOE. All TJEVs are altered. When finished, the bit corresponding to the JOE is turned off in every TJEV.
JOE=
Specifies the address of the work JOE or JOA whose corresponding bit in the TJEV is being managed.
SAPID=
Specifies the address in the SAPID data space of the control block representing the thread.
Note:
  1. Invalid operand if FUNC=PURGE, MOVE, or SEARCH,ANY.
  2. Required operand if FUNC=ADD or SEARCH.
NEWJOE=
Specifies the address of the JOE or JOA whose setting should be moved from the JOE indicated by the JOE= parameter.
Note: Valid only if FUNC=MOVE.
FOUND=
Specifies a label to be branched to or a register to be branched on if the bit is found when FUNC=SEARCH is specified.
NOTFOUND=
Specifies a label to be branched to or a register to be branched on if the bit is not found when FUNC=SEARCH is specified.

Return codes

The following return codes (decimal) are returned in register 15.
Return Code
Meaning
0

The return code is always zero for FUNC=ADD,PURGE,MOVE.

For the two SEARCH functions, 0 means not found.

4
For the two SEARCH functions, 4 means that the bit representing the JOE was found.
8
For the SEARCH,ANY function, 8 means that the bit representing JOE was found only in TJEV pointed to by the given SAPID.

Environment

JES2 main task

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014