Purpose
Request a snap dump of the contents of one or more areas maintained in memory for CA ADS. The dump produced by a SNAP command can be used to assess the use of system resources by an executing dialog.
Syntax
┌──────────────────────────────────────────────┐ ►►──── SNAP ───▼────┬─┬── ALL ──────────┬─────────────────┬───┴───────────────► │ │ │ │ │ │ ┌────────────┐ │ │ │ └─▼─┬─ OCB ─┬─┴──┘ │ │ ├─ OWA -─┤ │ │ ├─ OTB ─┤ │ │ ├─ OTBX ─┤ │ │ ├─ FDB ─┤ │ │ ├─ VDB ─┤ │ │ ├─ RBB ─┤ │ │ ├─ ADB ─┤ │ │ └─ TAT ─┘ │ │ ┌───────────────┐ │ └─ RECORDs - ( ─▼─ record-name ─┴─ ) ─┘ ►──┬──────────────────────────────────────────┬─── . ────────────────────────►◄ └─ TITLE ───┬──────┬──── 'title-text' ─────┘ ├─ IS ─┤ └─ = ─┘
Parameters
Writes all areas of memory maintained for the issuing dialog to the SNAP dump.
Keyword which requests the CA ADS control block. The OCB contains CA ADS system parameters specified in the system generation ADSO statement.
Keyword which specifies the CA ADS online work area. The OWA is maintained as a temporary storage buffer for application and dialog information used during CA ADS runtime processing. The OWA is not maintained across tasks.
Keyword which specifies the CA ADS terminal block. The OTB contains information about the current CA ADS session. The OTB is maintained across tasks.
Keyword which specifies the CA ADS terminal block extension. The OTBX is an extension of the OTB and contains pointers to the TAT, the ADSO-APPLICATION-GLOBAL-RECORD record buffer, the RBB, and the ADB for the currently executing application. The OTBX exists only for applications defined using the application compiler (ADSA).
Keyword which specifies the fixed dialog block. The FDB is the dialog load module created by the dialog compiler (ADSC). Information in the FDB includes executable process code and parameters required to execute the dialog, and information on the maps and records associated with the dialog.
Keyword which specifies the variable dialog block. One VDB exists for each operative dialog. A VDB contains runtime variable information about a dialog, such as the status of map fields, information concerning flow of control, addresses of records used by the dialog, and the address of the executing command.
The VDB is created dynamically for the issuing dialog at runtime.
Keyword which specifies the record buffer block. The RBB contains header information and buffers for all records associated with the current application.
Keyword which specifies the application definition block. The ADB is the application load module created by the CA/ADS online application compiler. The ADB contains the application information supplied on the definition screens during an application compiler session. The ADB exists only if the application is defined using the application compiler.
Keyword which specifies the task application table. The TAT contains the names of task codes used to initiate applications and the names of the applications (ADBs) thus initiated. The TAT exists only if there are applications on the system that are defined using the application compiler.
Includes information associated with the specified subschema, map, or work records in the SNAP dump. The information is taken from the RBB; it includes data, but no headers, from the buffers for the named records.
Record-name must be associated with the issuing dialog.
Specifies a title for the SNAP dump.
Title-text is a 1- to 90-character string enclosed in single quotation marks. The specified title is printed on the hard-copy listing of the SNAP dump.
Usage
Snap dumps are written to the DC/UCF log and can be printed by using the PRINT LOG print log utility.
Note: For more information about PRINT LOG, see the CA IDMS Utilities Guide.
|
Copyright © 2014 CA.
All rights reserved.
|
|