usmdump [-a] [-i user-identifier] [file-name]

The usmdump command dumps the contents of shared memory during OpenTP1 operation to a UNIX file in the dump directory ($DCDIR/spool/save). The dump file is then compressed by the compress command, or by the gzip command if you are using Linux.

-a

Dumps all of the information in the shared memory allocated to OpenTP1. If you omit the -a option, the command dumps information from only those areas in shared memory that are actually in use.

-i user-identifier

Specifies the user identifier for the shared memory to be dumped. The dumped information depends on the user identifier you specify. Specify one of the following user identifiers:

• all: Dumps all of the information in shared memory that is being managed by OpenTP1.
• BTN: Dumps the information in dynamic shared memory and static shared memory.
• Information set in OWNER at execution of the dcshmls -r command: Dumps the information in the shared memory pool for the service specified in OWNER. For example, specify dam to dump the information in the shared memory pool allocated to the DAM service.

When the dcshmls -r command is executed, btn is shown as the OWNER of the information in dynamic shared memory and static shared memory. To output this information, either omit the -i option, or specify BTN as the argument for the -i option.

If you omit this option, OpenTP1 operation is the same as if BTN were specified.

• file-name~<character string, 1-31 bytes> <<shmdump>>
  Specifies the output destination file to use when outputting the information in shared memory. The information in shared memory is dumped with the specified file name to $DCDIR/spool/save. If you specify the file name in the form $DCDIR/spool/save/file-name, make sure that the full path does not exceed 255 bytes. If you omit this command argument, the command outputs the information in shared memory to the file shmdump in $DCDIR/spool.