home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 11 / 11.iso / n / n008 / 7.ddi / CPIC / SIDEHELP.HLP (.txt) < prev    next >
Encoding:
Help Librarian Help File  |  1992-09-25  |  25.3 KB  |  448 lines
  1. C-Worthy (R) Help Librarian Data File Version 1.0
  2. COPYRIGHT (C) 1985 - 1989.  All Rights Reserved.
  3. Custom Design Systems, Inc.  Orem, Utah  USA.
  4.                     LOCAL LU CONFIGURATION DATA
  5.      LU Name:  The name (8 or fewer chacters) you create to 
  6.                identify local LU to NetWare LU6.2. 
  7.                Use only uppercase letters, numbers or the characters
  8.                $, #, and @. The first character must not be numeric.
  9.      PU Name:  The name (8 or fewer chacters) you create to 
  10.                define the PU's network name. 
  11.                Use only uppercase letters, numbers or the characters
  12.                $, #, and @. The first character must not be numeric.
  13.                                              Page 1 of 6
  14.                     LOCAL LU CONFIGURATION DATA
  15.      Network Name:  The name (8 or fewer chacters) you create to 
  16.                     define the network name that contains the PU.
  17.                     It is used during XID negotiation with other
  18.                     type 2.1 nodes. 
  19.                     Use only uppercase letters, numbers or the
  20.                     characters $, #, and @. The first character must
  21.                     not be numeric.
  22.      Security Type: Grants or denies access to various levels of
  23.                     security the remote LU may need in order to
  24.                     verify the request for accessing the remote LU's
  25.                     programs.
  26.                                              Page 2 of 6
  27.                     LOCAL LU CONFIGURATION DATA
  28.                     Values are:
  29.                     0 -  Specifies no conversation-level security enabled.
  30.                     1 -  Instructs the remote LU to supply the pre-approved
  31.                          user ID with the security request.
  32.                     2 -  Instructs the remote LU to use whatever security
  33.                          information is in the domain of the program.  If
  34.                          you use this value, you must also define the User
  35.                          ID and PassWord fields on this screen.
  36.      User ID:  The name (8 or fewer characters) you create to define the
  37.                user ID.  A user ID is required if a value of 2 is specified
  38.                for Security Type.
  39.                                                          Page 3 of 6>
  40.                     LOCAL LU CONFIGURATION DATA
  41.      Password: A string (8 or fewer characters) you create to
  42.                define the end user's password.  A password is
  43.                required if you specified a value of 2 for Security
  44.                Type.
  45.      LU Local Address:
  46.                The logical session number for the local LU. It must
  47.                be in the range from 0 to the number of host sessions
  48.                assigned to your workstation or server.
  49.                     
  50.                                              Page 4 of 6;
  51.                     LOCAL LU CONFIGURATION DATA
  52.                If the LU you are defining may engage in the host
  53.                LU-LU sessions, use a non-zero value that corresponds
  54.                to one of the host sessions you have customized to be
  55.                a LU6.2 session for your workstation or server.
  56.                
  57.                If the LU you are defining will engage only in
  58.                peer-to-peer sessions, set the address to 0.
  59.      LU SESSION LIMIT: 
  60.                Specifies the maximum number of concurrently active
  61.                sessions you want to allow between the local LU and
  62.                its remote LU.
  63.                Use decimal numbers only.
  64.                                              Page 5 of 6
  65.                     LOCAL LU CONFIGURATION DATA
  66.      DETACH PU TYPE: 
  67.                Specifies the manner in which LUs attached by your 
  68.                workstation or server detach from NetWare LU6.2.
  69.                Values are:
  70.                0 -  Immediately detaches all LUs attached by a 
  71.                     workstation or server if that unit requests
  72.                     immediate detachment.
  73.                1 -  Detaches all LUs attached by a workstation or 
  74.                     server if that unit requests detachment only in 
  75.                     the absence of outstanding conversations.
  76.                                              Page 6 of 6
  77.                       SIDE INFORMATION RECORD
  78.      Specify the name of the side information record that you want to create,
  79.      view, modify, or delete.
  80.      *  To name a new side information record, type a name (8 characters or
  81.         less) and press <Enter>.  Use alphanumeric characters only.
  82.      *  To list existing side information records in this file, press <Ins>.  
  83.      *  To select one of the listed records for viewing, modifying, or
  84.         deleting, use the arrow keys to select the record name and press
  85.         <Enter>.  Then press <Enter> again.
  86.      A description of side information record data follows.
  87.                                                             Page 1 of 2
  88.                       SIDE INFORMATION RECORD
  89.      Each side information record consists of configuration data about the
  90.      local LU, the remote LU, and the mode used between those two LUs.
  91.      The Local LU Data screen includes the following data: LU name,
  92.      PU Name, Network Name, Security Type, User ID, Password, LU Local 
  93.      address, LU session limit, and Detach PU type.
  94.      The Remote LU Data screen includes the following data: 
  95.      LU Name, Data Link Control Number, Network Adapter Number, Network
  96.      Adapter Address, LU Session Limit, Max Logical Record Size, Character
  97.      Set, Local Program Name, and Remote Program Name.
  98.      The Mode Configuration Data screen includes the following data: 
  99.      Mode Name, Max Negotiable Session Limit, Automatic Activate Session
  100.      Limit, Min Contention Winners Source, Min Contention Winners Target,
  101.      Pacing Size, Min RU Size, CNOS Flags, and CNOS Termination Set.
  102.                                                             Page 2 of 2=
  103.                        REMOTE LU CONFIGURATION DATA
  104.      LU Name:  The name (8 or fewer characters) that identifies the partner                LU to NetWare LU6.2.
  105.                Use only uppercase letters, numbers, or the character $, #, 
  106.                and @.  The first character must not be numeric.
  107.      Data Link Control Name: 
  108.                Gives the Data Link Control identification needed for 
  109.                communicating with the remote LU. Values are: ITRN, SDLC,
  110.                QLLC, or CUSTOM.  Descriptions follow. 
  111.                                                             Page 1 of 10
  112.                        REMOTE LU CONFIGURATION DATA
  113.           ITRN      Use this value for the following remote locations:
  114.                     
  115.                     (1) The remote LU is located in a workstation that is 
  116.                         supported by the same server as your workstation.
  117.                         Both Network Adapter Number and Network Adapter 
  118.                         Address must be set to 0.
  119.                     (2) The remote LU is located in a host accessed via a 
  120.                         token ring network adapter to an IBM 3174 control
  121.                         unit or an IBM 3725/3745 communications controller. 
  122.                         The Network Adapter Address must be set to the 3714
  123.                         or 37x5 node address.
  124.                     (3) The remote LU is located in another server that is 
  125.                         connected to the same token ring network as your 
  126.                         server. The Network Adapter Address must be set to
  127.                         the token ring node address of the remote LU's
  128.                         server. 
  129.                                                            Page 2 of 10
  130.                        REMOTE LU CONFIGURATION DATA
  131.                (4)  The remote and local LU's are running on the same
  132.                     server. 
  133.           SDLC - Use this value to establish a workstation-to-host or
  134.                  server-to-host connection via either a coaxial or a
  135.                  Synchronous Data Link Control adapter.
  136.           QLLC - Use this value to establish link connection via a
  137.                  Qualified Logical Link Control adapter.
  138.           CUSTOM - Use this value to establish link connection via
  139.                    any customized data link control adapter.
  140.                                                        Page 3 of 10
  141.           REMOTE LU CONFIGURATION DATA
  142.      Network Adapter Number:
  143.      Determines whether the token ring
  144.      network adapter by which the remote
  145.      LU is accessed is primary(0) or
  146.      alternate(1).
  147.      If you specify a peer-to-peer 
  148.      connection, set this field to 0.
  149.                          Page 4 of 10
  150.                      REMOTE LU CONFIGURATION DATA
  151.      Network Adapter Address:  Specifies the remote LU's adapter address
  152.           if the data link control name is ITRN or SDLC:
  153.                
  154.           If the remote LU is located in a workstation supported by a
  155.           server, set this parameter to the 6-byte locally administered
  156.           token ring address of the remote LU's server.
  157.                
  158.           If both workstations are supported by the same server,
  159.           set this parameter to binary zero (000000000000).
  160.           If the remote LU is located in a host accessed via a coaxial cable
  161.           or SDLC gateway server, set this parameter to binary zero
  162.           (000000000000).
  163.           If the remote and local LU's are located on the same server, set
  164.           this parameter to binary zero (000000000000).
  165.                                                        Page 5 of 10
  166.           REMOTE LU CONFIGURATION DATA
  167.           If the remote LU is located in a host accessed
  168.           by the NetWare token ring gateway server, set
  169.           this parameter to the 6-byte locally
  170.           administered address of the connected 3174/
  171.           37x5(for example: 40010020abef).
  172.      If the data link control name is QLLC the adapter
  173.      address is the target name for this link in the
  174.      X.25 configuration file. The target name can consist
  175.      of any alphabetic, numeric, or special ASCII
  176.      characters, and can be up to 16 characters long.
  177.                                         Page 6 of 10
  178.                        REMOTE LU CONFIGURATION DATA
  179.           If the data link control name is CUSTOM the adapter address 
  180.           is the target name of the customized data link control adapter.
  181.           The target name can consist of any alphabetic, numeric, or
  182.           special ASCII characters and can be up to 16 characters long.
  183.      LU Session Limit:
  184.           The maximum number of concurrently active sessions you will 
  185.           allow between the local LU and remote LU.
  186.      Max Logical Record Size:
  187.           Specifies the maximum logical record size a mapped conversation
  188.           can use when building a logical record.  Specify a decimal value
  189.           between 0 and 32767.  The default value, 0, is converted to the  
  190.           maximum record size, 32767. Values of 1, 2, or 3 are converted to
  191.           4.       
  192.                                                             Page 7 of 10Y0
  193.                     REMOTE LU CONFIGURATION DATA
  194.      Character Set: 
  195.           Specifies one of three character sets for character conversion
  196.           from EBCIDIC to ASCII or from ASCII to EBCIDIC. Values are 0,
  197.           1, or 2.
  198.           0    specifies the following set: lower-cased a-z; numerics 0-9;
  199.                and special characters $,#,@, and (.).  No restrictions of 
  200.                position of characters.  Trailing blanks are allowed.
  201.           1    specifies the following set: lower-cased a-z; uppercase A-Z;
  202.                numerics 0-9, and special characters $, #, and @.
  203.                When converting ASCII to EBCIDIC lowercase is converted to 
  204.                uppercase; when converting in either direction, the first
  205.                character can not be numeric, trailing blanks are allowed. 
  206.                                                             Page 8 of 10
  207.                     REMOTE LU CONFIGURATION DATA
  208.           2    specifies the following set: any kind of character allowed,
  209.                but under the following conditions:
  210.                  
  211.                *    You have provided a proper conversion code table to 
  212.                     NetWare LU6.2.
  213.                *    You have customized NetWare LU6.2 for that table.
  214.      Local Program Name: 
  215.           Specifies the name of the NetWare LU6.2 program associated with the
  216.           local LU.  The maximum length is 64 characters.
  217.           
  218.                                                                  Page 9 of 10 
  219.                     REMOTE LU CONFIGURATION DATA
  220.      Remote Program Name: 
  221.           Specifies the name of the NetWare LU6.2 program associated with 
  222.           the remote LU.  The maximum length is 64 characters.
  223.                                                             Page 10 of 10&7
  224.                     MODE FILE CONFIGURATION DATA
  225.     Mode Name: The name (8 or fewer characters) you create to 
  226.                identify the partner LU to NetWare LU6.2.
  227.                Use only uppercase letters, numbers, or the characters
  228.                $, #, and @. The first character must not be numeric.
  229.     Max Negotiable Session Limit: 
  230.                Specifies the number of sessions you want to permit
  231.                a CNOS verb to specify for the local LU and the 
  232.                remote LU using this mode.  The actual maximum may 
  233.                be a smaller value, depending on the results of 
  234.                CNOS negotiation.
  235.                Specify using decimal values.
  236.                                                   Page 1 of 13
  237.                     MODE FILE CONFIGURATION DATA
  238.      Automatic Activate Session Limit: 
  239.                Specifies the number of contention-winner sessions
  240.                from the local LU that NetWare LU6.2 automatically
  241.                activates during the CPI-C application subsystem 
  242.                process.
  243.                Specify a decimal number.
  244.                                                   Page 2 of 13
  245.                     MODE FILE CONFIGURATION DATA
  246.      Min Contention Winners Source: 
  247.                     Specifies the minimum number of sessions that
  248.                     will guarantee the source (i.e. local) LU to be
  249.                     the session contention winner.
  250.                     Specify a decimal number greater than or equal
  251.                     to 0.
  252.      Min Contention Winners Target: 
  253.                     Specifies the minimum number of sessions that
  254.                     will guarantee the target(i.e. remote) LU to be
  255.                     the session contention winner.
  256.                     Specify a decimal number greater than or equal
  257.                     to 0. 
  258.                                                      Page 3 of 13
  259.                     MODE FILE CONFIGURATION DATA
  260.  Pacing Size:  Specifies the maximum number of SNA messages that the
  261.                local LU can receive without sending a pacing
  262.                response.  Serves as a form of buffer control.
  263.                Values are integers 0 through 63. 0 directs NetWare
  264.                LU6.2 not to use any pacing.
  265.  Max RU Size:  Defines the maximum Request Unit (RU) sizes that may
  266.                be used by sessions that have this mode. 
  267.                Specify integers from 16 to 4096.  For efficiency, 
  268.                a minimum setting of 256 is recommended.
  269.                                                   Page 4 of 13
  270.                     MODE FILE CONFIGURATION DATA
  271.  Min RU Size:  Defines the minimum Request Unit (RU) sizes that may
  272.                be used by sessions that have this mode.
  273.                Specify integers from 16 to 4096.  For efficiency, a 
  274.                minimum setting of 256 is recommended.
  275.  CNOS Flags:   Specifies a combination of four field settings for the
  276.                APPC CNOS Flag parameter:
  277.                     Mode_Name_Select_One or Mode_Name_Select_All,
  278.                     Set_Negotiable_Yes or Set_Negotiable_No,
  279.                     Initiated_Yes or Initiated_No, and
  280.                     Sync_Level_None or Sync_Level_Confirm.
  281.                Functions of the above settings follow:
  282.                                                   Page 5 of 13DE
  283.                     MODE FILE CONFIGURATION DATA
  284.        Mode_Name_Select_One - Specifies that only the mode name 
  285.                               defined in the NetWare LU6.2 CNOS
  286.                               function call will be affected by
  287.                               changes to session limits and
  288.                               polarities.
  289.        Mode_Name_Select_All - Specifies that all session limits and
  290.                               polarities for all mode names that
  291.                               belong to the target(i.e. remote)
  292.                               LU shall be changed.
  293.        Set_Negotiable_No -    Does not allow NetWare LU6.2 to
  294.                               override session limits.
  295.        Set_Negotiable_Yes -   Allows NetWare LU6.2 to override
  296.                               session limits. 
  297.                                                   Page 6 of 13iH
  298.                     MODE FILE CONFIGURATION DATA
  299.        Initiated_Yes -   Indicates that the CPIC application 
  300.                          subsystem initiates a CNOS call for this
  301.                          mode file.
  302.        Initiated_No -    Indicates that the CPI-C application
  303.                          subsystem does not initiate a CNOS call for
  304.                          this mode file.
  305.        Sync_Level_None - Specifies no synchronization level between
  306.                          the local transaction program and the remote
  307.                          transaction program.
  308.     Sync_Level_Confirm - Specifies the confirm synchronization level
  309.                          between the local and remote transaction.
  310.         
  311.                                                   Page 7 of 13
  312.                     MODE FILE CONFIGURATION DATA
  313.  Acceptable values for CNOS FLAGS and the settings they specify are listed
  314.  below:
  315.  0 - Mode_Name_Select_One; Set_negotiable_No; Initiated_No; Sync_Level_None
  316.  1 - Mode_Name_Select_All; Set_negotiable_No; Initiated_No; Sync_Level_None
  317.  2 - Mode_Name_Select_One; Set_Negotiable_Yes; Initiated_No;Sync_Level_None
  318.  3 - Mode_Name_Select_All; Set_Negotiable_Yes; Initiated_No;Sync_Level_None
  319.  4 - Mode_Name_Select_One; Set_Negotiable_No; Initiated_Yes;Sync_Level_None
  320.  5 - Mode_Name_Select_All; Set_Negotiable_No; Initiated_Yes;Sync_Level_None
  321.  6 - Mode_Name_Select_One; Set_Negotiable_Yes; Initiated_Yes; 
  322.      Sync_Level_None
  323.  7 - Mode_Name_Select_All; Set_Negotiable_Yes; Initiated_Yes;
  324.      Sync_Level_None
  325.  8 - Mode_Name_Select_One; Set_Negotiable_No; Initiated_No;
  326.      Sync_Level_Confirm
  327.                                                        Page 8 of 13
  328.                     MODE FILE CONFIGURATION DATA
  329.   9 - Mode_Name_Select_All; Set_Negotiable_No; Initiated_No;
  330.       Sync_Level_Confirm
  331.  10 - Mode_Name_Select_One; Set_Negotiable_Yes; Initiated_No;
  332.       Sync_Level_Confirm
  333.  11 - Mode_Name_Select_All; Set_Negotiable_Yes; Initiated_No;
  334.       Sync_Level_Confirm
  335.  12 - Mode_Name_Select_One; Set_Negotiable_No; Initiated_Yes;
  336.       Sync_Level_Confirm
  337.  13 - Mode_Name_Select_All; Set_Negotiable_No; Initiated_Yes;
  338.       Sync_Level_Confirm
  339.  14 - Mode_Name_Select_One; Set_Negotiable_Yes; Initiated_Yes
  340.       Sync_Level_Confirm
  341.  15 - Mode_Name_Select_All; Set_Negotiable_Yes; Initiated_Yes
  342.       Sync_Level_Confirm
  343.                                              Page 9 of 13lR
  344.                     MODE FILE CONFIGURATION DATA
  345.      CNOS Termination Set: 
  346.      Specifies a combination of three field settings for the CNOS Flag
  347.      parameter: Responsible_Source or Responsible_Target;
  348.                 Drain_Source_Yes or Drain_Source_No
  349.                 Drain_Target_Yes or Drain_Target_No
  350.      Functions of the possible settings follow:
  351.      Responsible_Source  Specifies that the source LU is solely responsible 
  352.                          for deactivating sessions.
  353.           
  354.      Responsible_Target  Specifies that the target LU is initially  
  355.                          responsible for deactivating sessions.  The target 
  356.                          LU can negotiate this responsibility with the source
  357.                          LU and make the source LU responsible.
  358.                                                                Page 10 of 13
  359.                     MODE FILE CONFIGURATION DATA
  360.      Drain_Source_No -   Does not allow the source LU to void its
  361.                          allocation requests.
  362.      Drain_Source_Yes -  Allows the source LU to void its allocation 
  363.                          requests.
  364.                              
  365.      Drain_Target_No -   Does not allow the target LU to void its
  366.                          allocation requests.
  367.      Drain_Target_Yes -  Allows the target LU to void its allocation
  368.                          requests.
  369.                                                   Page 11 of 13
  370.                     MODE FILE CONFIGURATION DATA
  371.      Acceptable values for CNOS Termination and the settings they 
  372.      specify are:
  373.      0 - Responsible_Source; Drain_Source_No; Drain_Target_No
  374.      1 - Responsible_Source; Drain_Source_No; Drain_Target_Yes
  375.      2 - Responsible_Source; Drain_Source_Yes; Drain_Target_No
  376.      3 - Responsible_Source; Drain_Source_Yes; Drain_Target_Yes
  377.      4 - Responsible_Target; Drain_Source_No; Drain_Target_No
  378.      5 - Responsible_Target; Drain_Source_No; Drain_Target_Yes
  379.      6 - Responsible_Target; Drain_Source_Yes; Drain_Target_No
  380.      7 - Responsible_Target; Drain_Source_Yes; Drain_Target_Yes
  381.                                                   Page 12 of 13
  382.                  MODE FILE CONFIGURATION DATA
  383.      SAA Service Profile Name: 
  384.           Specifies an SAA Service Profile to be used for this session.
  385.           The name can be from 1 to 8 characters long.
  386.           This field applies only to side information files used by the
  387.           CPIC NLM in the Netware Communication Services environment.
  388.           It is not required for side information files used by CPI-C 
  389.           programs at the DOS-based NetWare 3270 Workstation.
  390.           An SAA service profile is a collection of information about the
  391.           server's connection to the SNA host as well as the sessions to
  392.           be obtained through that connection. For example, the service
  393.           profile specifies the number of LUs available on the host, the
  394.           types of LUs available, and the users authorized to use the LUs.
  395.                                                             Page 13 of 13 
  396.        Exit Side Information File Command
  397.  If you are finished using the Side Information
  398.  File utility, answer YES; otherwise, answer NO
  399.  or press <Esc>.
  400.  No changes will be lost by exiting at this
  401.  point.
  402.                                    Page 1 of 1
  403.         Create A Side Information File
  404.  Type the name of the side information file
  405.  that you want to create and press <Enter>.
  406.  If the file is in not in the current
  407.  directory, you must include the path of the
  408.  file name. For example, "c:\cpi\Example.cpi".
  409.  The filename extension must be "cpi".
  410.                                Page 1 of 1
  411.          Create A Side Information File
  412.          Editing A Side Information File
  413.  Type the name of the side information file
  414.  you want to edit and press <Enter>.
  415.  If the file is not in the current directory,
  416.  include the path of the filename.
  417.  To list all side information files in the 
  418.  current directory, press <Ins>.
  419.                               Page 1 of 1
  420.           Add A Side Information Record
  421.  This command creates a new side information
  422.  record that will be saved in the side
  423.  information file.
  424.  The side information record name must be
  425.  unique among all other side information
  426.  records contained in the current side
  427.  information file. 
  428.                          Page 1 of 1
  429.        Delete A Side Information Record
  430.  Type the name of the side information record
  431.  that you want to delete from the side infor-
  432.  mation file and then press <Enter>.
  433.  To list all the side information records in
  434.  the side information file, press <Ins>.
  435.                               Page 1 of 1
  436.         Modify A SIde Information Record
  437.  Type the name of the side information record
  438.  you want to modify and press <Enter>.
  439.  To list all side information records in the
  440.  side information file, press <Ins>.
  441.                               Page 1 of 1
  442.        Display A Side Information Record
  443.  Enter the name of the side information record
  444.  you want to display and press <Enter>.
  445.  To list all the side information records in
  446.  the side information file, press <Ins>.
  447.                               Page 1 of 1
  448.