TAA Tools
RTVREGINF       RETRIEVE REGISTRATION INFORMATION      TAAREGC

The  Retrieve Registration  Information  command retrieves  information
as displayed  with WRKREGINF.  RTVREGINF retrieves  information for one
exit    point.      The    Retrieve   Server   Authentication   Entries
(QsyRetrieveServerEntries) API is used.

A typical command would be:

            DCL         &RIENAM *CHAR LEN(20)
             .
            RTVREGINF   EXITPNT(xxx) RIENAM(&RIENAM)

The format name and program number default to *FIRST.

The name of the  first exit point would  be returned for the  specified
exit point.

RTVREGINF escape messages you can monitor for
---------------------------------------------

      CPF3CDB    Exit point does not exist

Escape messages from based on functions will be re-sent.

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

   EXITPNT       The exit point name.

   FORMAT        The exit  point's format.   A name or generic  name (8
                 characters)  may be entered.   *FIRST  is the default.

   PGMNBR        The program number of the  exit point.  *FIRST is  the
                 default.   A number  in the range  of 1  to 2147482647
                 may be entered

   PGMDTA        A  two part  parameter to  describe the  program data.
                 If program data  is not specified,  the first  program
                 (if any) is returned for the exit point/format.

                 The first  part is  the starting  position within  the
                 data where  the search for  the data will  begin.  *NO
                 is  the default  meaning do  not use  the program data
                 when searching.

                 The second part  is the program  data itself.  *NO  is
                 the default  meaning do not use the  program data when
                 searching.  Up to 256 bytes may be entered.

   RIENAM        The  exit  point name.    This is  an  optional return
                 parameter that  if used  must  be specified  as  *CHAR
                 LEN(20).

   RIEFMT        The  format  name.     This  is  an   optional  return
                 parameter  that  if used  must be  specified  as *CHAR
                 LEN(8).

   RIEMAX        The maximum number of  exit programs.   A value of  -1
                 is returned  for *NOMAX.   This is an  optional return
                 parameter  that  if used  must  be  specified as  *DEC
                 LEN(10 0).

   RIECUR        The  current  number of  exit  programs.   This  is an
                 optional  return  parameter  that  if  used   must  be
                 specified as *DEC LEN(10 0).

   RIEDRG        Whether  to allow  de-registration.   Y or  N  will be
                 returned.   This is an  optional return parameter that
                 if used must be specified as *CHAR LEN(1).

   RIECHG        Whether  to   allow   changes  to   the   registration
                 information.   Y or N  will be  returned.  This  is an
                 optional  return   parameter  that  if  used  must  be
                 specified as *CHAR LEN(1).

   RIEREG        The registered exit point.   Y or N will be  returned.
                 This  is an  optional return  parameter  that if  used
                 must be specified as *CHAR LEN(1).

   RIEADN        The  pre-processing exit  program name  for  adding an
                 exit  point.   This  is  an optional  return parameter
                 that if used must be specified as *CHAR LEN(10).

   RIEADL        The library  of the  pre-processing exit program  name
                 for  adding  an  exit  point.   This  is  an  optional
                 return  parameter that  if used  must be  specified as
                 *CHAR LEN(10).

   RIEADF        The format  name of  the pre-processing  exit  program
                 name for  adding an exit point.   This is  an optional
                 return  parameter that  if used  must be  specified as
                 *CHAR LEN(8).

   RIERMN        The name of the  pre-processing exit program name  for
                 removing an  exit point.   This is an  optional return
                 parameter  that if  used  must be  specified  as *CHAR
                 LEN(10).

   RIERML        The  library name  of the  pre-processing exit program
                 name  for  removing  an  exit  point.    This   is  an
                 optional  return  parameter  that   if  used  must  be
                 specified as *CHAR LEN(10).

   RIERMF        The  format name  of  the pre-processing  exit program
                 name  for  removing  an  exit  point.    This  is   an
                 optional  return  parameter  that   if  used  must  be
                 specified as *CHAR LEN(8).

   RIERTN        The  name of the pre-processing  exit program name for
                 retrieving  an  exit  point.    This  is  an  optional
                 return parameter  that if  used must  be specified  as
                 *CHAR LEN(10).

   RIERTL        The  library name of  the pre-processing  exit program
                 name  for  retrieving  an  exit  point.    This  is an
                 optional  return  parameter  that  if  used   must  be
                 specified as *CHAR LEN(10).

   RIERTF        The  format name  of the  pre-processing exit  program
                 name  for  retrieving  an  exit  point.    This is  an
                 optional  return  parameter  that  if  used  must   be
                 specified as *CHAR LEN(8).

   RIEDSL        The  exit  point  description location.    The  values
                 returned  will  be   *MSGF  or  *TEXT.    This  is  an
                 optional  return  parameter  that  if  used  must   be
                 specified as *CHAR LEN(5).

   RIEMFN        The exit  point description message  file.   The value
                 will  be  blank  if  RIEDSL  is  *TEXT.   This  is  an
                 optional   return  parameter  that  if  used  must  be
                 specified as *CHAR LEN(10).

   RIEMFL        The  exit  point  description  message  file  library.
                 The value will  be blank if RIEDSL is  *TEXT.  This is
                 an  optional  return parameter  that if  used  must be
                 specified as *CHAR LEN(10).

   RIEMID        The exit  point  description message  ID.   The  value
                 will  be  blank  if  RIEDSL is  *TEXT.    This  is  an
                 optional  return   parameter  that  if  used  must  be
                 specified as *CHAR LEN(7).

   RIETXT        The exit point  text description.   The value will  be
                 blank  if  RIEDSL  is *MSGF.    This  is  an  optional
                 return  parameter that  if used  must be  specified as
                 *CHAR LEN(50).

   RIPNBR        The  exit program number.  The  value will be 0 if the
                 exit  program is  not  found.   This  is  an  optional
                 return  parameter that  if used  must be  specified as
                 *DEC LEN(10 0).

   RIPPGM        The  exit program  name.   This is an  optional return
                 parameter that  if used  must  be specified  as  *CHAR
                 LEN(10).

   RIPLIB        The  library  of  the  exit   program.    This  is  an
                 optional  return   parameter  that  if  used  must  be
                 specified as *CHAR LEN(10).

   RIPDSL        The exit  point  description  location.    The  values
                 will be *MSGF  or *TEXT.   This is an  optional return
                 parameter  that if  used  must be  specified  as *CHAR
                 LEN(5).

   RIPMFN        The  exit point  description message  file name.   The
                 value will be  blank if RIPDSL is  *TEXT.  This is  an
                 optional  return  parameter  that   if  used  must  be
                 specified as *CHAR LEN(10).

   RIPMFL        The   exit  point  description  message  file  library
                 name.  The  value will  be blank if  RIPDSL is  *TEXT.
                 This  is an  optional  return parameter  that if  used
                 must be specified as *CHAR LEN(10).

   RIPMID        The  exit  point description  message ID.    The value
                 will be  blank  if  RIPDSL  is  *TEXT.    This  is  an
                 optional  return  parameter  that  if   used  must  be
                 specified as *CHAR LEN(7).

   RIPTXT        The exit  point text description.   The value  will be
                 blank  if  RIPDSL  is  *MSGF.    This  is  an optional
                 return parameter  that if  used must  be specified  as
                 *CHAR LEN(50).

   RIPCCSID      The  exit program  data CCSID.   This  is  an optional
                 return  parameter that  if used  must be  specified as
                 *DEC LEN(5 0).

   RIPTHRSAF     The thread safety  status of  the exit program  entry.
                 The values will be  Y, N, or U (unknown).   This is an
                 optional  return   parameter  that  if  used  must  be
                 specified as *CHAR LEN(1).

   RIPTHRACN     The action to  be taken when  calling an exit  program
                 in a multi-threaded job.

                 '1' means to send  an escape and do not  call the exit
                 program.     CPF3C80  may   be  used  as   the  escape
                 message).

                 '2'  means  to send  an  informational message  and do
                 not call  the exit program.   CPF3C80  may be used  as
                 the informational message.

                 This  is an  optional  return parameter  that if  used
                 must be specified as *CHAR LEN(1).

   RIPDTL        The  length  of the  exit program  data.   This  is an
                 optional  return  parameter  that  if  used  must   be
                 specified as *DEC LEN(5 0).

   RIPDTA        The exit  program data.   This  is an  optional return
                 parameter  that  if used  must be  specified  as *CHAR
                 LEN(2048).


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

None.

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

The following TAA Tools must be on your system:

     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information

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

None, the tool is ready to use.

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

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

   RTVREGINF     *CMD                   TAAREGC       QATTCMD
   TAAREGCC      *PGM       CLP         TAAREGCC      QATTCL
   TAAREGCR      *PGM       RPGLE       TAAREGCR      QATTRPG
					

Added to TAA Productivity tools January 1, 2008


Home Page Up to Top