HELPLIB.HLB  —  SET  ACCOUNTING
    Controls the current accounting file.

    Requires OPER (operator) privilege.

    Format

      SET ACCOUNTING

1  –  Qualifiers

1.1    /DISABLE

       /DISABLE[=(keyword[,...])]

    Prevents the tracking of the resources specified by the keywords.

    The following table lists the keywords you can use to specify the
    type of resource.

    Keyword          Type of Resource

    IMAGE            Resources used by an image

    LOGIN_FAILURE    Resources used by an unsuccessful attempt to log
                     in

    MESSAGE          Unformatted record written to the accounting
                     file by a call to the $SNDJBC system service

    PRINT            Resources used by a print job

    PROCESS          Resources used by a process

    You do not need to stop the tracking of all processes and images.
    You can prevent resources being tracked for specific types of
    process and for images running in these types of process.

    The following table lists the keywords you can use to specify the
    type of process.

    Keyword        Type of Process

    BATCH          Batch process

    DETACHED       Detached process

    INTERACTIVE    Interactive process

    NETWORK        Network process

    SUBPROCESS     Subprocess (the parent process can be a batch,
                   detached, network, or interactive process)

    If the system is no longer tracking any resources, /DISABLE
    closes the current accounting file.

    If you use the /DISABLE qualifier and omit the keywords, the
    current accounting file does not track any resources, and the
    system closes the file.

1.2    /ENABLE

       /ENABLE[=(keyword[,...])]

    Enables the tracking of the specified resources, and opens the
    current accounting file if it is not already open.

    The following table lists the keywords you can use to specify the
    type of resource.

    Keyword          Type of Resource

    IMAGE            Resources used by an image

    LOGIN_FAILURE    Resources used by an unsuccessful attempt to log
                     in

    MESSAGE          (Unformatted record written to the accounting
                     file by a call to the $SNDJBC system service)

    PRINT            Resources used by a print job

    PROCESS          Resources used by a process

    You do not need to track all processes and images. You can track
    resources for specific types of process and for images running in
    those types of process.

    The following table lists the keywords you can use to specify the
    type of process.

    Keyword        Type of Process

    BATCH          Batch process

    DETACHED       Detached process

    INTERACTIVE    Interactive process

    NETWORK        Network process

    SUBPROCESS     Subprocess (the parent process can be a batch,
                   detached, network, or interactive process)

    If you use the /ENABLE qualifier and omit the keywords, the
    current accounting file tracks all resources.

1.3    /LOG

    Writes information to the current SYS$OUTPUT device as the
    command executes.

1.4    /NEW_FILE

    Closes the current accounting file, and starts up a new version
    of it.

    The name of the new file depends on whether the logical name
    ACCOUNTNG is defined in your system logical name table.

    If this logical name is not defined, the SET ACCOUNTING command
    opens the file SYS$MANAGER:ACCOUNTNG.DAT.

    If this logical name is defined, the command opens the file
    that this logical name points to. If you omit the directory,
    SYS$MANAGER is the default, and if you omit the file type, .DAT
    is the default.

    The /NEW_FILE qualifier writes a record to the end of the old
    file that contains a forward pointer to the new file, and a
    record to the beginning of the new file that contains a backward
    pointer to the old file. These records contain the names of the
    new and old files respectively.

2  –  Examples

    1.$ SET ACCOUNTING /DISABLE /ENABLE=(PROCESS,BATCH,INTERACTIVE)
      $ SET ACCOUNTING /ENABLE=IMAGE

      This example tells the system to track the resources used only
      by batch and interactive processes, and by images running
      in batch and interactive processes. It illustrates the
      cumulative effect of /ENABLE and /DISABLE qualifiers, and of
      SET ACCOUNTING commands.

      The /DISABLE qualifier prevents the tracking of all resources.
      The /ENABLE qualifier then tells the system to track the
      resources used by batch and interactive processes. The second
      SET ACCOUNTING command tells the system to track the resources
      used by images.

    2.$ SET ACCOUNTING /NEW_FILE
      $ RENAME SYS$MANAGER:ACCOUNTNG.DAT;-1 WEEK_24_RESOURCES.DAT

      This example closes the current accounting file, opens a
      new version of it, and changes the name of the old file to
      WEEK_24_RESOURCES.DAT.
Close Help