Menu principal                 [Fechar]
Introdução
Divisões
Identification Division
Environment Division
Data Division
Procedure Division
Comandos CICS
VSAM - File Status
Quadros importantes
SQL - Structured Query Language
Outros programas
Rotinas prontas
Palavras reservadas
Introdução ao Oracle
Sites de busca
Sites interessantes
Meu e-mail

CICS Manual do Usuário - INQUIRE TASK LIST


Volta a página anterior

Volta ao Menu Principal


Desenvolvido por DORNELLES Carlos Alberto - Analista de Sistemas - Brasília DF. - cad_cobol@hotmail.com

INQUIRE TASK LIST

Retrieves a list of user tasks.

Sintaxe: 


INQUIRE TASK LIST
 
>>-INQUIRE TASK LIST--LISTSIZE(data-area)--+--------------+----->
                                           '-DISPATCHABLE-'
 
>--+---------+--+-----------+--+--------------+----------------->
   '-RUNNING-'  '-SUSPENDED-'  '-SET(ptr-ref)-'
 
>--+---------------------+-------------------------------------><
   '-SETTRANSID(ptr-ref)-'
Note:
SUSPENDED ignored by TXSeries for Multiplatforms.

Descrição:

INQUIRE TASK LIST retrieves a list of user tasks that are identified by task number, and optionally a second list of user tasks that are identified by transaction identifier.
User tasks are tasks that are associated either with user-defined transactions or with CICS-supplied transactions that are normally invoked by an operator.

You can request a list of those user tasks that are DISPATCHABLE (ready to run) or RUNNING at the time of the inquiry.
If you omit these options from the INQUIRE TASK LIST command, CICS returns a list of all the user tasks that are in any state.

Opções:

    DISPATCHABLE
  • Specifies that information is required about all user tasks that are currently dispatchable (that is, ready to run).
    LISTSIZE(data-area)
  • Returns a 32-bit binary field that indicates the number of task identifiers that have been returned in the area that is addressed by the SET value.
  • If the SET option is omitted, the number of tasks is still returned in the LISTSIZE field.
  • If no tasks are in any of the categories that you have specified, a zero value is returned.
    RUNNING
  • Specifies that information is required about all user tasks that are currently running.
    SET(ptr-ref)
  • Returns a pointer reference that is set to the address of the returned list of unsigned 32-bit binary task numbers.
  • If no tasks are in any of the categories that you have specified, a null value is returned.
  • See Null values.
  • CICS acquires the storage for this list as required, and frees it either when the next INQUIRE TASK LIST command is issued or at task termination.
  • This storage cannot be freed explicitly by the application that issues the INQUIRE TASK LIST command.
  • See INTO and SET for more information about using this option.
    SETTRANSID(ptr-ref)
  • Returns a pointer reference that is set to the address of a list of four-byte transaction identifiers.
  • If no tasks are in any of the categories that you have specified, a null value is returned.
  • See Null values.
  • CICS acquires the storage for this list as required, and frees it either when the next INQUIRE TASK LIST command is issued or at task termination.
  • This storage cannot be freed explicitly by the application that issues the INQUIRE TASK LIST command.
    SUSPENDED
  • Specifies that information is required about all user tasks that are currently suspended (that is, not ready to run).
  • However, the SUSPENDED option is ignored by TXSeries for Multiplatforms, because no tasks can be in this state.

Informações relacionadas:

© Copyright IBM Corp.