TAA Tools
CHGFUNCNAM      CHANGE FUNCTION NAME                   TAAJOFX

The Change Function Name  command allows you to change  the description
of the  Function field on  WRKACTJOB to provide a  better indication of
what  a job is  doing.  The  command must be  used in a  CL program and
not from a  command entry line.   The value  on WRKACTJOB would  appear
as USR-xxxx where xxxx is the 10 bytes specified on CHGFUNCNAM.

The value  is retained  until another CHGFUNCNAM  command is used  or a
return to a command entry type display occurs.

The QWCCCJOB API is used.

A typical command issued in a CL program would be:

             CHGFUNCNAM   FUNCTION(PAYUPDATE)

The Function name would appear on WRKACTJOB as:

          USR-PAYUPDATE

The  change is retained until  another CHGFUNCNAM command  is used or a
return to a command entry type display occurs.

There are situations where the system  will change the name to its  own
value such  as when  a job log  is output  or a dump  occurs.   Some of
these  changes may  be  temporary while  the system  function  is being
performed and some may act  as if a return  to a command entry  display
has occurred.

CHGFUNCNAM escape messages you can monitor for
----------------------------------------------

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

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

   FUNCTION      The  Function   name  to   appear  on  the   WRKACTJOB
                 display.   The Function will appear  as USR-xxxx where
                 xxxx  is the name you specified.   The command must be
                 issued in a  CL program and  not from a command  entry
                 display.

                 The Function  name will be retained  until another use
                 of  CHGFUNCNAM or  a  return to  a command  entry type
                 display occurs.

                 *BLANK may  be specified  to blank  the Function  name
                 on the WRKACTJOB display.


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

See the prior FUNCTION parameter description.

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
   ------        ----    ---------      ----------    ----------

   CHGFUNCNAM    *CMD                   TAAJOFX       QATTCMD
   TAAJOFXC      *PGM       CLP         TAAJOFXC      QATTCL
					

Added to TAA Productivity tools July 15, 2012


Home Page Up to Top