home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / vgserv45.zip / PTB / hptwgs2 / EPFIHELP.INF (.txt) < prev    next >
OS/2 Help File  |  1996-01-29  |  8KB  |  300 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Using Command Line Parameters ΓòÉΓòÉΓòÉ
  3.  
  4. The user can enter the parameters at the command prompt following the 
  5. INSTALL.EXE, the EPFIDLDS.EXE or the EPFINSTS.EXE file. The information passed 
  6. as values of these parameters is used by EPFINSTS.EXE during installation 
  7. processing. 
  8.  
  9. You should document how to use these parameters if your users install your 
  10. product differently from what you specified in your IIRC.RC resource file. Or, 
  11. you can supply a command file to the user with the necessary parameters. 
  12.  
  13. If no parameters are specified when the executable file is started, the 
  14. installation is attended. To install in an unattended mode, the /X parameter 
  15. must be used. Unattended includes what is sometimes referred to as lightly 
  16. attended. In the lightly attended mode, someone might have to start an 
  17. executable file or insert diskettes. 
  18.  
  19. If the value of any of the parameters contains spaces, use double quotes to 
  20. enclose the value. 
  21.  
  22. Values can be upper or lower case. Parameters can be in any order. 
  23.  
  24. <command> /A:<action>
  25.           /C:<catalog file name>
  26.           /G:<include path>
  27.           /L:<xpos,ypos>
  28.           /L1:<error log>
  29.           /L2:<history log>
  30.           /L3:<log file>
  31.           /L4:<log file>
  32.           /L5:<log file>
  33.           /NMSG
  34.           /O:<originating system>
  35.           /P:<product name>
  36.           /R:<response file>
  37.           /S:<source location>
  38.           /T:<install target directory>
  39.           /TU:<update CONFIG.SYS directory>
  40.           /X  <interactive_flag>
  41.  
  42. The /A, /C, and /P parameters are required for an installation that is started 
  43. with the EPFINSTS command. If the action is an install or an update, the /O is 
  44. also required. The /A, /C, /L, /O, /P, /R, and /S parameters override values 
  45. you have set in the IIRC.RC. 
  46.  
  47. Note:  The drive/directory/filename path is required for all log parameters 
  48. specified with the INSTALL.EXE or EPFIDLDS.EXE commands. The directories for L1 
  49. and L2 log files will be created if they do not exist. The directories for all 
  50. other log files must exist before starting the commands. 
  51.  
  52.  
  53. ΓòÉΓòÉΓòÉ 2. Parameter Definitions ΓòÉΓòÉΓòÉ
  54.  
  55. The command prompt parameters are: 
  56.  
  57.  /A:<action> 
  58.    Specifies the action of the EPFINSTS.EXE. 
  59.  
  60.    If you use this parameter, the main window of the installation is not 
  61.    displayed. 
  62.  
  63.    If you do not use this parameter, the installation starts normally with all 
  64.    windows displayed. 
  65.  
  66.    Valid values for this parameter are: 
  67.  
  68.         'D'       For delete 
  69.         'I'       For install 
  70.         'R'       For restore 
  71.         'U'       For update 
  72.  
  73.    Software Installer sets the EPFIACTION installation variable to the action. 
  74.  
  75.  /C:<catalog file name> 
  76.    Specifies the name and location of the catalog file that you want to be 
  77.    opened automatically. 
  78.  
  79.    If the catalog file is located on a host session, the host session ID must 
  80.    precede the catalog file name. If the catalog file is located on a drive, a 
  81.    drive and directory must precede the catalog file name. 
  82.  
  83.    Software Installer sets the EPFICATALOG installation variable to the name of 
  84.    the catalog file. 
  85.  
  86.    The following examples show how to use this parameter for each installation 
  87.    source. 
  88.  
  89.      o  For Drive:  /C:A:\DISK1.ICF 
  90.      o  For MVS:   /C:B:EPF.V1R2M0.SEPFBENU(EPFICAT) 
  91.      o  For VM:   /C:"B:EPFICAT ENUEPF12 *" 
  92.      o  For VSE:   /C:B:LIB.SUBLIB.MEMBERNAME.MEMBERTYPE 
  93.  
  94.    If only the host session ID is specified, for example, B: then the Open 
  95.    catalog window is displayed with B: as the default session or drive. 
  96.  
  97.  /G:<include path> 
  98.    Specifies the drive and directory of the general response files that are 
  99.    included by the specific response file. 
  100.  
  101.    Software Installer sets the EPFIGENRESPDIR installation variable to the 
  102.    included path. 
  103.  
  104.    Example: 
  105.  
  106.          /G:L:\XYZ
  107.  
  108.  /L:<xpos,ypos> 
  109.    Specifies the initial horizontal and vertical coordinates of the initial 
  110.    installation window on the Workplace Shell* relative to the lower-left 
  111.    corner of the screen. 
  112.  
  113.    If this parameter is specified, all previously saved default positions are 
  114.    overridden. 
  115.  
  116.    Software Installer sets the EPFIWNDCOORDS installation variable to the 
  117.    coordinates of the Installation and Maintenance window. 
  118.  
  119.  /L1:<error log> 
  120.    Specifies the drive, path, and file name of the error log file. 
  121.  
  122.    Software Installer sets the EPFIERRORLOG installation variable to the name 
  123.    of the error log. 
  124.  
  125.    Note:  The drive/directory/filename path is required. The directory for the 
  126.    log file must already exist. 
  127.  
  128.    All lines logged to the error file are prefixed with a time stamp. The time 
  129.    stamp has the following format: 
  130.  
  131.       YYYY-MM-DD HH:mm:SS:cc
  132.    Where: 
  133.  
  134.        YYYY is the year.
  135.        MM is the month.
  136.        DD is the day.
  137.        HH is the hour.
  138.        mm is the minute.
  139.        SS is the second.
  140.        cc is the hundredth of a second.
  141.  
  142.    The date and time separators are the current user-defined settings in the 
  143.    Country object of the System Settings folder. The default separators are the 
  144.    hyphen and the colon, respectively. 
  145.  
  146.    Example of using the /L1 parameter to create ERROR.LOG file in the C:\ABC\ 
  147.    directory: 
  148.  
  149.          /L1:C:\ABC\ERROR.LOG
  150.  
  151.  /L2:<history log> 
  152.    Specifies the drive, path, and file name of the history log file. Software 
  153.    Installer sets the EPFIHISTORYLOG installation variable to the name of the 
  154.    history log. 
  155.  
  156.    Note:  The drive/directory/filename path is required. The directory for the 
  157.    log file must already exist. 
  158.  
  159.    If this parameter is not specified, no history log is maintained. 
  160.  
  161.    All lines logged to the history file are prefixed with a time stamp. The 
  162.    time stamp has the following format: 
  163.  
  164.       YYYY-MM-DD HH:mm:SS:cc
  165.    Where: 
  166.  
  167.        YYYY is the year.
  168.        MM is the month.
  169.        DD is the day.
  170.        HH is the hour.
  171.        mm is the minute.
  172.        SS is the second.
  173.        cc is the hundredth of a second.
  174.  
  175.    The date and time separators are the current user-defined settings in the 
  176.    Country object of the System Settings folder. The default separators are the 
  177.    hyphen and the colon, respectively. 
  178.  
  179.    Example of using the /L2 parameter to create HISTORY.LOG file in the C:\ABC\ 
  180.    directory: 
  181.  
  182.          /L2:C:\ABC\HISTORY.LOG
  183.  
  184.  /L3:  /L4:  /L5:<log files> 
  185.    Each of these parameters specifies a drive, path, and file name of a log 
  186.    file. They are saved in installation variables EPFIL3LOG, EPFIL4LOG, and 
  187.    EPFIL5LOG for your use. 
  188.  
  189.    Note:  The drive/directory/filename path is required. The directories for 
  190.    the log files must already exist. 
  191.  
  192.  /NMSG 
  193.    Specifies that the ending message will not be displayed. 
  194.  
  195.  /O:<originating system> 
  196.    Specifies the originating system of the installation. Valid values are: 
  197.  
  198.      o  DRIVE 
  199.      o  MVS 
  200.      o  VM 
  201.      o  VSE 
  202.  
  203.    Software Installer sets the EPFISOURCE installation variable to one of these 
  204.    values. 
  205.  
  206.  /P:<product name> 
  207.    Provides the name of the product for the specified action. 
  208.  
  209.    If you do not use this parameter, the installation comes up normally with 
  210.    all windows displayed. 
  211.  
  212.    The <product name> should match the value of the NAME keyword of the PACKAGE 
  213.    entry in the catalog file. If your product name string includes any spaces, 
  214.    use double quotes around the string. For example: 
  215.  
  216.          /p:"product name with spaces"
  217.  
  218.    Software Installer sets the EPFIPRODUCT installation variable to the name of 
  219.    the product. 
  220.  
  221.  /R:<response file> 
  222.    Specifies the drive, path, and file name of the specific response file. 
  223.  
  224.    The following search order is used to find the response files. 
  225.  
  226.      1. The fully-qualified file specification 
  227.      2. The current directory. The current directory is the temporary directory 
  228.         where epfinsts.exe is running. The response file can be placed in the 
  229.         current directory by packing it in INSTALL.IN_. 
  230.      3. The file name together with the /G: invocation parameter 
  231.      4. Each directory in the PATH environment variable 
  232.      5. Each directory in the DPATH environment variable 
  233.  
  234.    Software Installer sets the EPFIRESPFILE installation variable to the 
  235.    response file. 
  236.  
  237.    Example: 
  238.  
  239.          /R:L:\XYZ\RESPONSE.DAT
  240.  
  241.  /S:<source_location> 
  242.    Specifies the drive and path that contains the source files to install. 
  243.  
  244.    Software Installer sets the EPFISOURCEDIR installation variable to the 
  245.    source_location. 
  246.  
  247.    Specifying this parameter overrides the value of the HOSTLOC keyword in the 
  248.    product's catalog file PACKAGE entry. 
  249.  
  250.    If this parameter is not specified, the value of the HOSTLOC keyword is not 
  251.    overridden. 
  252.  
  253.    Example: 
  254.  
  255.          /S:L:\XYZ
  256.  
  257.  /T:<install target directory> 
  258.    Specifies the drive and path where the product files are installed. 
  259.  
  260.    This parameter only affects the value of the FILE directory (directory 
  261.    corresponding to the FILELABEL keyword). If this parameter is specified, it 
  262.    overrides the FILE paths that are specified in the response files and the 
  263.    package files. 
  264.  
  265.    Software Installer sets the EPFITARGETDIR installation variable to the 
  266.    install target directory. 
  267.  
  268.    Example: 
  269.  
  270.          /T:C:\IBB
  271.  
  272.  /TU:<update target CONFIG.SYS directory> 
  273.    Specifies the drive and path of the target CONFIG.SYS to be updated. 
  274.  
  275.    Software Installer sets the EPFITARGETCNF installation variable to the 
  276.    update CONFIG.SYS target directory. 
  277.  
  278.    If this parameter is not specified, the CONFIG.SYS files are updated as 
  279.    specified in the product's package file. 
  280.  
  281.    Example: 
  282.  
  283.          /TU:C:\
  284.  
  285.  /X 
  286.    Specifies that the action is unattended. 
  287.  
  288.    If you do not specify all of the information needed for the action to 
  289.    complete, an error occurs. When you specify the /X option, no progress 
  290.    indication is shown and all error messages are logged to the error file you 
  291.    specified using the /L1 parameter. 
  292.  
  293.    If you do not specify this option, the user is prompted for any information 
  294.    that the EPFINSTS.EXE needs to complete the action. In this attended mode of 
  295.    action, progress indication is shown and error messages are displayed to the 
  296.    user in secondary windows. 
  297.  
  298.    Software Installer sets the EPFINONINTERACT installation variable to YES if 
  299.    the /X parameter is specified. 
  300.