#
# COMPONENT_NAME: userExit
#
# FUNCTIONS:  This is the user exit definition file read by the TeamConnection
#             Server software upon invocation of the TeamConnection server daemons.
#             This file can be updated automatically using the 'tcadmin' tool,
#             on operating systems where it is available.  Also, TeamConnection
#             family administrators can update this file directly to define the
#             names of user exit programs to be invoked at different stages
#             in the execution of TeamConnection actions.  The complete list of
#             valid TeamConnection actions is available from 'tcadmin' or from
#             the 'teamc Report -userExitInfo' action.
#
# NOTE:       When using 'tcadmin', this entire file is rewritten upon update.
#             All comments entered directly into this file will be lost.
#
# ORIGINS: 27
#
# PARTIAL PROGRAM (PP) SOURCE MATERIALS
# 5622-717 (C) COPYRIGHT International Business Machines Corp. 1996
# 5765-039 (C) COPYRIGHT International Business Machines Corp. 1991,1993
# 5765-207 (C) COPYRIGHT International Business Machines Corp. 1993
# 5765-202 (C) COPYRIGHT International Business Machines Corp. 1993
# 5622-063 (C) COPYRIGHT International Business Machines Corp. 1993
# All Rights Reserved
# US Government Users Restricted Rights - Use, duplication or
# disclosure restricted by GSA ADF Schedule Contract with IBM Corp.
#
# -------------------------------------------------------------------------
#
# The following tables show the parameters passed to the user exit
# programs defined for the PartAdd TeamConnection action.  This information
# is provided so that you can make use of the parameters being passed to your
# user exit programs by the TeamConnection Server software.
#
# At the end of this file is an example of a user exit definition.  Add
# your own definitions to the end of this file.  For more information on
# user exits, refer to the IBM TeamConnection Server Administration and Installation
# guide.
#
#
# ===================
# PartAdd, ExitID = 0
# ===================
# -------------------------------------------------------------------------
# Argument Number       Argument Number         Argument Value
# in an executable      in a shell program
# source (eg. C)
# -------------------------------------------------------------------------
#     arg[0]                   $0               User exit program name
#     arg[1]                   $1               User defined parameter - should be in quotes
#     arg[2]                   $2               Environment file name - null if not used
#     arg[3]                   $3               File path name
#     arg[4]                   $4               '0' if the file will not be
#                                               transmitted; othewise the
#                                               file will be transmitted.
#     arg[5]                   $5               Client location
#     arg[6]                   $6               Temp file on server
#
#     arg[7]                   $7               Release name
#     arg[8]                   $8               Component name
#     arg[9]                   $9               File type: set to '1' if
#                                                  binary is specified at
#                                                  file creation; otherwise
#                                                  set to '0'
#     arg[10]                  $10              FileMode
#     arg[11]                  $11              Parent name
#     arg[12]                  $12              Parser name
#     arg[13]                  $13              Builder name
#     arg[14]                  $14              Parent relation type
#     arg[15]                  $15              Builder parms
#     arg[16]                  $16              Part type
#     arg[17]                  $17              Parent type
#     arg[18]                  $18              Temporary to build
#     arg[19]                  $19              Effective TeamConnection user ID
#     arg[20]                  $20              Real Unix login
#     arg[21]                  $21              Verbose flag
# -------------------------------------------------------------------------
#
# =======================
# PartAdd, ExitIDs = 1, 2
# =======================
#
# same as ExitID 0 without real Unix login
#
# ===================
# PartAdd, ExitID = 3
# ===================
#
# same as ExitID 0 with an additional parameter as the last parameter to
# indicate the last user ExitID that has been executed successfully, for
# example, 0 or 1.
#
#
# Example User Exit Definition
# ----------------------------
#
# PartAdd 0 copyrightCheck "1991 1992"  # run copyright for PartAdd with UEparm '1991 1992'
#
# The above user exit definition would be invoked before the TeamConnection Server
# software performs any of its own verification checks for the part creation
# command since the exit id is 0.
#
# Example User Exit Definition with environment file used
# -------------------------------------------------------
#
# PartAdd 0 copyrightCheck "1991 1992" ENV=(component,release) #
#
# The above user exit definition would be invoked before the TeamConnection Server
# software performs any of its own verification checks for the part creation
# command since the exit id is 0.
#
# NOTES:
# - The examples above are representative of the output from the 'tcadmin' tool.
# - When this file is updated by the 'tcadmin' tool, the following will occur:
#   - userExit will be renamed to userExit.bak
#   - all comments in the previous userExit will be written into the new file
#     above the list of actions.  In other words, any comments that are currently
#     mixed with actions will be moved above the actions
#   - any previously backed-up file will be overwritten
#   - if there is no previous userExit file, the userExit file that was installed
#     with TeamConnection will be used
#   - blank lines will be removed.
#
# Add your User Exit Definitions here
# -----------------------------------
