Skip to Content
Information
Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

File Utility Primary Commands

Related topics

Quick-Reference

Code Debug CICS Primary Commands

Primary Commands for Code Debug CICS

Application-and-system-primary-commands

This section summarizes the primary commands specific to File Utility functions. For information on primary commands for application and system functions, see Primary Commands.

CANCEL

Cancels updates made on the DB2 Display screens (5.5.4, 5.5.5, and 5.5.6). Can also be used on the Edit DL/1 Segment screen (5.4.4) to roll back any changes made for the currently scheduled PSB.

image2021-8-28_23-31-29.png

CHECK

Checks syntax on the DB2 Build SQL Easy Query screen (5.5.2).

image2021-8-28_23-31-40.png

CLOSE

Closes a data set on the Edit CICS Data set Record screen (5.1.3) or a transient data queue on the Edit Transient Data Queue Record screen (5.3.2).

image2021-8-28_23-31-51.png

CREATE

Writes a generated SQL call to the SQL transfer data set on the DB2 Browse Generated SQL Call screen (5.5.3). Key-name is the name of the record to which the SQL call is written.

image2021-8-28_23-32-2.png

DELETE

Deletes a record from a data set on the Edit CICS Data set Record screen (5.1.3) or a temporary storage queue on the Edit Queued Record screen (5.2.3). Deletes an MQ message on the Browse MQ Queue Message screen (5.6.2) or Update MQ Queue Message screen (5.6.3). Deletes a record from an intrapartition transient data queue.

image2021-8-28_23-32-13.png

DLET

Issues a DL/I DLET call to delete a segment from a database on the Edit DL/1 Segment screen (5.4.4).

image2021-8-28_23-32-26.png

EXEC

Ends the current function and transfers to the File Utility Menu (5).

image2021-8-28_23-32-40.png

FIND

Positions the cursor on a string or data item.

image2021-8-28_23-32-55.png

The begcol and endcol variables are only available on the following screens:

  • Browse CICS Data set (5.1.2)
  • Edit CICS Data set Record (5.1.3)
  • Browse Temporary Storage (5.2.2)
  • Edit Queued Record (5.2.3).

FIRST

Gets the first message from a queue on the Browse MQ Queue Record screen (5.6.2).

image2021-8-28_23-33-10.png

GETPUT

Deletes the currently accessed message from an MQ queue and adds a new message to the queue on the Update MQ Queue Message screen (5.6.3).

image2021-8-28_23-33-59.png

GHN

Issues a DL/I Get Hold Next call on a database on the Edit DL/1 Segment screen (5.4.4).

image2021-8-28_23-34-10.png

GHNP

Issues a DL/I Get Hold Next within Parent call on a database on the Edit DL/1 Segment screen (5.4.4).

image2021-8-28_23-34-19.png

GHU

Issues a DL/I Get Hold Unique call on a database on the Edit DL/1 Segment screen (5.4.4).

image2021-8-28_23-34-29.png

GN

Issues a DL/I Get Next call on a database on the Edit DL/1 Segment screen (5.4.4).

image2021-8-28_23-34-37.png

GNP

Issues a DL/I Get Next within Parent call on a database on the Edit DL/1 Segment screen (5.4.4).

image2021-8-28_23-34-46.png

GU

Issues a DL/I Get Unique call on a database on the Edit DL/1 Segment screen (5.4.4).

image2021-8-28_23-35-6.png

HEX

Selects a display mode on five of the File Utility screens. The available formats are character-format (HEX OFF), dump format (HEX DUMP), or vertical hexadecimal (HEX ON or HEX VERT).

image2021-8-28_23-35-0.png

INSERT

Creates a new I/O area or increases the length of the current I/O area.

image2021-8-28_23-35-19.png

ISRT

Issues a DL/I ISRT call on a database to insert a segment on the Edit DL/1 Segment screen (5.4.4).

image2021-8-28_23-35-31.png

LOCATE

Locates specific information depending on the screen from which the command is entered.

List Screens

Locates a file resource on List screens (5.1.1, 5.2.1, 5.3.1, 5.4.1, 5.4.2, 5.4.3, 5.5.1, 5.5.2, 5.5.4, 5.5.5, and 5.6.1).

image2021-8-28_23-36-25.png


File Utility Display Screens

Locates a record field on the Edit Record (5.1.3, 5.2.3, and 5.3.2), Edit DL/1 Segment (5.4.4), and DB2 Edit Composite Column (5.5.6) screens when a record has been mapped with the USING command.

image2021-8-28_23-36-38.png

NEXT

Accesses the next record on the Edit CICS Data set Record (5.1.3), Edit Queued Record (5.2.3), and Edit Transient Data Queue Record (5.3.2.) screens.

image2021-8-28_23-36-50.png

OPEN

Opens a data set on the Edit CICS Data set Record screen (5.1.3), or a transient data queue on the Edit Transient Data Queue Record screen (5.3.2).

image2021-8-28_23-37-10.png

PCB

Schedules a DL/I PSB for processing on the Edit DL/1 Segment screen (5.4.4).

image2021-8-28_23-37-20.png

PREV

Accesses previous record on the Edit CICS Data set Record (5.1.3) and Edit Queued Record (5.2.3) screens.

image2021-8-28_23-37-43.png

PUT

Adds a message to an MQ queue on the Update MQ Queue Message screen (5.6.3).

image2021-8-28_23-37-55.png

READ

Reads a record on the Edit Record screens (5.1.3, 5.2.3, and 5.3.2).

image2021-8-28_23-38-4.png

REFRESH

Redisplays the list of queues on the MQ Queue List screen (5.6.1).

image2021-8-28_23-38-14.png

REMOVE

Decreases the length of the I/O area.

image2021-8-28_23-38-26.png

REPL

Issues a DL/I REPL call to replace an existing segment in a database on the Edit DL/1 Segment screen (5.4.4).

image2021-8-28_23-38-35.png

REPLACE

Replaces specified record in the SQL transfer data set with the generated SQL call that is currently displayed on the DB2 Browse Generated SQL Call screen (5.5.3). Key-name is the name of the record to which the SQL call is written.

image2021-8-28_23-38-45.png

RESET

Restores excluded columns on the DB2 Build SQL Easy Query screen (5.5.2).

image2021-8-28_23-38-55.png

REWRITE

Rewrites a record on the Edit CICS Data set Record (5.1.3) and Edit Queued Record (5.2.3) screens.

image2021-8-28_23-39-13.png

SHOW

Modifies the format of selected screens to display data in different forms.

Edit DL/1 Segment Screen (5.4.4)

Changes the display format.

image2021-8-28_23-39-36.png


Db2 Screens

Displays the SQL generated by a Db2 Easy Query or executes the SQL call and displays the result table on all DB2 Easy Query (5.5) screens.

image2021-8-28_23-39-47.png


File Mapping Screens

Displays information in the SHOW field on the Edit Record (5.1.3, 5.2.3, and 5.3.2), Edit DL/1 Segment (5.4.4), DB2 Edit Composite Column (5.5.6) screens, Browse MQ Queue Message (5.6.2), and Update MQ Queue Message (5.6.3).

image2021-8-28_23-40-9.png

TERM

Terminates a currently scheduled DL/I PSB on the Edit DL/1 Segment screen (5.4.4).

image2021-8-28_23-40-22.png

UPDATE

Transfers from the Browse MQ Queue Message screen (5.6.2) to the Update MQ Queue Message screen (5.6.3) with the currently accessed message.

image2021-8-28_23-40-34.png

USING

Formats the current I/O area according to the specified COBOL or PL/I 01 level data name on the Edit Record (5.1.3, 5.2.3, and 5.3.2), Edit DL/1 Segment (5.4.4), DB2 Edit Composite Column (5.5.6) screens, Browse MQ Queue Message (5.6.2), and Update MQ Queue Message (5.6.3).

image2021-8-28_23-41-29.png

WRAUX

Writes a record to auxiliary temporary storage on the Edit Queued Record screen (5.2.3).

image2021-8-28_23-41-38.png

WRITE

Writes a record on the Edit Record screens (5.1.3, 5.2.3, and 5.3.2).

image2021-8-28_23-41-48.png


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI DevX Code Debug for CICS 17.02