CICS Manual do Usuário - INQUIRE FILE (browse)

INQUIRE FILE (browse)

Browses information about the files that you are authorized to access.

Sintaxe:

INQUIRE FILE (browse)
 
>>-INQUIRE FILE START------------------------------------------><

Condition: ILLOGIC

INQUIRE FILE (browse)
 
>>-INQUIRE--FILE(data-area)--NEXT------------------------------><

Condição: END, ILLOGIC

Notas:

Other options same as for INQUIRE FILE.

INQUIRE FILE (browse)
 
>>-INQUIRE FILE END--------------------------------------------><

Condição: ILLOGIC

Descrição:

These commands allow you to browse through the runtime File Definitions (FD) that you are authorized to access.
The sequence of browsing is strictly undefined, but continued browsing does guarantee to return all the definitions that you are authorized to access.
Only one FILE browse operation is allowed at any one time in a given task.
See Browsing resource definitions for more information.

Opções:

END

Terminates the browsing operation and frees any held resources.

FILE(data-area)

Returns an eight-character string that represents the name of the file for which information is retrieved on an INQUIRE FILE NEXT command.

Retrieves the name and any requested attributes of the next (that is, first or subsequent) FD that is to be accessed.

START

Initializes the scan of the FD in preparation for a series of INQUIRE FILE NEXT commands.
Note that no information about files is retrieved until an INQUIRE FILE NEXT command is executed.

Condições:

END

Occurs on an INQUIRE FILE NEXT command if all authorized FD entries have been accessed.
Default action: Terminates the task abnormally.

ILLOGIC

Occurs for the following conditions:
- An INQUIRE FILE START command is issued when a browse of the FD is already in progress.
- An INQUIRE FILE NEXT or INQUIRE FILE END command is issued, but an INQUIRE FILE START command has not been successfully issued.
Ação pré-definida: Terminates the task abnormally.

Informações relacionadas: