CHKOBJ3         CHECK OBJECT 3                         TAAOBJY

 The Check  Object 3 command  is like the  system CHKOBJ command  except
 that  a better first  level message (including  the type of  object) is
 sent  if  the object  is not  found.   CHKOBJ  sends a  CPF9801 message
 where the  first  level text  reads  'Object xxxx  in library  yyy  not
 found'.   Typical error text  from CHKOBJ3 would  be 'File xxxx  in yyy
 not found'.

 The  command  parameters  are  identical  between  CHKOBJ  and  CHKOBJ3
 except  that  CHKOBJ3  also  supports  the  value  *LAST  for  the  MBR
 parameter.

 The intent of CHKOBJ3  is that you would use it when  you do not intend
 to  monitor  for  the  CPF9801  not  found  message,  but want  a  more
 descriptive first level of error text sent.

 The escape message sent is TAA9801  (not CPF9801).  Most common  object
 type such  as *PGM  are spelled  out as  'Program' in the  text of  the
 message.

 The  other  escape messages  normally  sent by  CHKOBJ  are re-sent  by
 CHKOBJ3 such as CPF9802 (not authorized) and CPF9815 (no member).

 Command parameters                                    *CMD
 ------------------

    OBJ           The  qualified name of the object  to be checked.  The
                  library value  defaults to  *LIBL.   *CURLIB may  also
                  be used.

    OBJTYPE       The object  type to  be checked.   The same  values as
                  supported  by  CHKOBJ are  provided.   Prompt  for the
                  list.

    MBR           The member to be  checked for a data  base file.   The
                  default  is *NONE  meaning no  member is  checked.   A
                  member  name  or the  special values  *FIRST  or *LAST
                  may be used to check a member.

    AUT           The  authorization  to  the  object  to  be   checked.
                  *NONE is the  default meaning that only  the existence
                  of  the object  will be  checked and  not if  the user
                  has any authority to the object.

                  The  same  values as  exist  on CHKOBJ  with  the same
                  meaning may be specified.  Prompt for the list.

 Restrictions
 ------------

 None.

 Prerequisites
 -------------

 The following TAA Tools must be on your system:

      EXTLST2         Extract list 2
      RTVOBJTYPD      Retrieve object type description
      SNDESCMSG       Send escape message

 Implementation
 --------------

 None, the tool is ready to use.

 Objects used by the tool
 ------------------------

    Object        Type    Attribute      Src member    Src file
    ------        ----    ---------      ----------    ----------

    CHKOBJ3       *CMD                   TAAOBJY       QATTCMD
    TAAOBJYC      *PGM       CLP         TAAOBJYC      QATTCL

Added to TAA Productivity Tools January 1, 1998


Home Page

Last modified on March 10, 2014 © 1995, 2014 - TAA Tools, Inc.