TCPIP$UCP_HELP.HLB  —  ANALYZE

1  –  CONTAINER

    Verifies the integrity of a UNIX container file, including the
    following checks:

    o  Superblock validation

    o  Inode validation

    o  Directory validation

    o  Internal allocation validation

    o  Directory hierarchy validation

    Reports, and optionally corrects, problems within the structure
    of the container directory. Applies to the NFS server.

    Related commands: DIRECTORY, MAP, UNMAP

    Format

      ANALYZE CONTAINER  device:path.name

                         [ /[NO]CONFIRM ]

                         [ /[NO]REPAIR ]

1.1  –  Restrictions and Tips

    o  Before you enter the ANALYZE CONTAINER command, you must map
       the OpenVMS volume on which the container directory resides,
       using the MAP command.

    o  Before you enter the ANALYZE CONTAINER command, unmap the
       container file system to prevent users from attempting to
       access to it while you analyze it.

    o  This command requires the BYPASS privilege.

1.2  –  Parameters

 device:path.name

    Required.

    Device and container directory to analyze.

1.3  –  Qualifiers

1.3.1    /CONFIRM

       /CONFIRM
       /NOCONFIRM

    Optional. Default: /NOCONFIRM.

    Use only with the /REPAIR qualifier.

    When the software encounters a problem with the services
    database, it displays a description and solution and then
    requests confirmation before making each correction. For example:

 %TCPIP-E-ANA_SUP_BADIICGSIZE, Problem: Bad initial inode cell group
 size:bad_value
 Solution: Will be replaced by default size: good_value
       CONFIRM [Y/N/G]:

    Respond to the CONFIRM: prompt by entering one of the following:

    o  Y to repair the problem

    o  N to ignore the problem

    o  G to change to NO CONFIRMATION mode

1.3.2    /REPAIR

       /REPAIR
       /NOREPAIR

    Optional. Default: /NOREPAIR.

    Any errors will be repaired.

1.4  –  Examples

    1.TCPIP> UNMAP "/wren20"
      TCPIP> ANALYZE CONTAINER DUA0:[WREN20]

      Verifies the integrity of container DUA0:[WREN20].

2  –  MAIL

    Verifies the consistency of the SMTP queues with SMTP control
    files.

    Related commands: REMOVE MAIL, SHOW MAIL

    Format

      ANALYZE MAIL  [ user ]

                    [ /[NO]CONFIRM ]

                    [ /DELETE[=options ]

                    [ /HOLD=time ]

                    [ /LOG=file ]

                    [ /[NO]REPAIR ]

2.1  –  Restrictions

    Requires SYSNAM, SYSPRV, or BYPASS privilege to access mail that
    is not yours.

2.2  –  Parameters

 user

    Optional. Default: All users.

    User whose mail you want to analyze.

2.3  –  Qualifiers

2.3.1    /CONFIRM

       /CONFIRM
       /NOCONFIRM

    Optional. Default: /NOCONFIRM

    Use only with either the /REPAIR or the /DELETE qualifier.

    When the software encounters a problem, it displays a description
    and solution. If you specify the /CONFIRM qualifier, the software
    then requests confirmation before making a correction or deleting
    each record. Enter one of the following:

    o  Y to repair the problem

    o  N to ignore the problem

    o  G to change to NO CONFIRMATION mode

2.3.2    /DELETE

       /DELETE [=BEFORE=time | =SINCE=time]

    Optional. Default: Files not deleted.

    Deletes each control file without a corresponding queue entry.

    o  =BEFORE=time

       -  Deletes files created before the specified time.

       -  Default: Current date and time.

    o  =SINCE=time

       -  Deletes files created since the specified time.

       -  Default: Deletes all files.

    Use the /DELETE and /REPAIR qualifiers on the same command line
    only if their time frames do not conflict.

    The following command requeues lost mail created since yesterday
    and deletes all previous mail:

    TCPIP> ANALYZE MAIL /REPAIR /DELETE=BEFORE=YESTERDAY

2.3.3    /HOLD

       /HOLD=time

    Optional. Default: Immediate retransmission.

    Hold, until the specified time, lost control files that you
    requeued.

2.3.4    /LOG

       /LOG[=file]

    Optional. Default: [current_default_dir]:TCPIP$SMTP_ANALYZE.LOG.

    Writes the ANALYZE MAIL log to the specified file.

2.3.5    /REPAIR

       /REPAIR
       /NOREPAIR [=BEFORE=time | =SINCE=time]

    Optional. Default: /NOREPAIR.

    Corrects errors as follows:

    o  Resubmits for delivery each valid control file in the SMTP
       directory with no entry in an SMTP queue.

    o  Deletes each invalid control file (fails the internal
       consistency check) and the corresponding queue entry.

    o  Either requeues or deletes messages placed on hold.

    Supports the following options:

    o  =BEFORE=time

       -  Deletes files created before the specified time.

       -  Default: Current date and time.

    o  =SINCE=time

       -  Deletes files created since the specified time.

       -  Default: Deletes all files.

    Do not use /REPAIR with /DELETE if their time frames conflict.

2.4  –  Examples

    1.TCPIP> ANALYZE MAIL /REPAIR

      Displays status for the SMTP queues, and requeues each valid
      control file that lacks a corresponding queue entry.

    2.TCPIP> ANALYZE MAIL /DELETE

      Creates the summary of SMTP queues, and deletes each valid
      control file that lacks a corresponding SMTP queue entry.

    3.TCPIP> ANALYZE MAIL DRAKE

      %TCPIP-I-ANA_RUNING, ANALYZE runs on node DODO

      %TCPIP-I-ANA_NOENTR, no queue entry found for file
      NEST3$:[DRAKE]93042311394417_DRAKE.TCPIP_DODO;1

      %TCPIP-I-ANA_COMPLE, ANALYZE completed on node DODO

      %TCPIP-I-ANA_FEPAIR, found 0 file-queue entry pairs
      %TCPIP-I-ANA_DELQEN, deleted 0 queue entries
      %TCPIP-I-ANA_FILNOQ, found 1 files with no queue entries
      %TCPIP-I-ANA_FILHLD, holding 0 files in directory
      %TCPIP-I-ANA_FILDEL, deleted 0 files from the Postmaster directory
      %TCPIP-I-ANA_SUBFIL, submitted 0 files to the generic queue
      %TCPIP-I-ANA_FILACE, encountered 0 file access errors
      %TCPIP-I-ANA_NONCFF,found 0 non-unknown files in Postmaster directory
      %TCPIP-I-ANA_FILCOR,found 0 corrupted CFfiles in Postmaster directory
      TCPIP>

      Creates a summary of SMTP entries and control files for user
      DRAKE.

    4.TCPIP> ANALYZE MAIL DRAKE /REPAIR /DELETE=BEFORE=24-APR-2003

      This command does the following:

      o  Creates a summary of SMTP entries and control files for user
         DRAKE.

      o  Requeues control files that lack corresponding queue
         entries.

      o  Deletes control files created before April 24, 2003.

3  –  SERVICE

    Searches through the services database for corrupted definitions.
    Displays invalid records and, with the /REPAIR qualifier, deletes
    them.

    Related commands: SET SERVICE, SHOW SERVICE

    Format

      ANALYZE SERVICE  [ /[NO]CONFIRM ]

                       [ /[NO]REPAIR ]

3.1  –  Restrictions

    Requires write access to the directory with the services
    database.

3.2  –  Qualifiers

3.2.1    /CONFIRM

       /CONFIRM
       /NOCONFIRM

    Optional. Default: /NOCONFIRM.

    Use only with the /REPAIR qualifier.

    When the software encounters a problem, it displays a description
    and a solution. If you specify the /CONFIRM qualifier, the
    software then requests confirmation before making a correction.

    Respond to the CONFIRM: prompt by entering one of the following:

    o  Y to repair the problem

    o  N to ignore the problem

3.2.2    /REPAIR

       /REPAIR
       /NOREPAIR

    Optional. Default: /NOREPAIR

    Deletes the corrupted records.

3.3  –  Examples

    1.TCPIP> ANALYZE SERVICE

                          Invalid IP option records
          Service             Port  Proto    Process          Address

          TOE                   25  TCP      TOED             0.0.0.0
          NESTING              560  TCP      NEW_EGGS_TCPIP   0.0.0.0

      IP option records
        Total:              0
        Invalid:            0

      TCP option records
        Total:              7
        Invalid:            2

      Displays total and invalid protocol option records found in two
      service definitions, TOE and NESTING.

    2.TCPIP> ANALYZE SERVICE /REPAIR /CONFIRM

                          Invalid IP option records
          Service             Port  Proto    Process          Address

          TOE                   67  UDP      TOED             0.0.0.0
      Remove? [N]: YES

          Service             Port  Proto    Process          Address

          NESTING               69  UDP      NEW_EGGS_TCPIP   0.0.0.0
      Remove? [N]: YES

      Displays the total protocol option records and deletes, after
      confirmation, the invalid records.
Close Help