Reference Guide › Command Reference › EXTRACT Command

EXTRACT Command

Use the EXTRACT command to extract information from USER, IDENTITY, and SUBCONFIG directory entries.

EXTRACT [“Parms” [HOLD]]

Parms:

{filename | EXTRACT} [{filetype | DIRECT} [{filemode | A1]]

Definitions

[filename [filetype[filemode]]]

Specifies the filename, filetype, and filemode of the file that will contain the extracted information. The default is EXTRACT DIRECT A1. Creates a file that contains those directory entries that are not on hold.

[HOLD]

Creates a file that contains only those directory entries on hold.

Description

The EXTRACT command creates a condensed source directory file, which includes information extracted from directory entries. This file can be used by utilities such as the CA VM:Account VMJSCD utility.

The output file created by the EXTRACT command contains the following statement types:

• USER
• IDENTITY
• SUBCONFIG
• ACCOUNT
• DEDICATE
• MDISK
• ACIGROUP (CA VM:Secure only)

Any USER, IDENTITY, or MDISK statements in the EXTRACT file appear with logon passwords masked and minidisk passwords eliminated.

To extract information for all user IDs (those on HOLD and those not on HOLD), you must issue the EXTRACT command twice.

If a file of the specified name (or the default file if no name is specified) already exists on your A‑disk, it is replaced by the file created by this command.

You must have a read/write A‑disk to run this command.