Con-nect Help System

The help system maintains two forms of help texts: system texts and user texts.

All help texts delivered with Con-nect are considered system texts. System texts will be overwritten/updated (new fields, new maps) with the help texts of future Con-nect releases.

User texts may be company- or application-specific texts and are not affected by new Con-nect releases. The person authorized to maintain the user texts is also responsible for updating the texts.

Online creation and modification of the user texts is permitted only for persons who have been authorized to do so (with function F of HMENU, see below).

This document covers the following topics:


Online Con-nect

When you display a help text and you are an authorized user, PF2 is assigned "Mod" (modify).

If the displayed help text is a user text and you press PF2, you can modify your user text.

However, if the help text is a system text and you press PF2, the directory record (i.e. the header line containing the topics and the map/field name) is copied and an empty editor page is displayed in which you can enter the new help text (see the example screen below).

You can use the following Con-nect editor line commands to modify your help text (see the Con-nect User's Guide, section Text Processing):

,C
,D
,I
,MX
,W
,X
,Y
,CX-Y
,MX-Y

Note:
System texts themselves cannot be modified online.

  14:31                * * *  C O N - N E C T  2  * * *                14.Feb.94
  Cabinet LS                          Menu                               Tuesday
           Name G-COMMAND                                     91-06-18 ADMIN    
     Description  The Command Line____________________________________________  
         Topics AACOMMAND______ COMMAND________ OBJECT_________ ALIAS__________ 
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
For intensified text: use !! to switch on and >> to switch off            
      ---PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12-
   .           Save  Quit  Top   +Page -Page Bottom                             

To save the help text, you must press PF2 once more (this PF-key has been assigned "Save"). To exit from the editor, press PF3.

From now on, all users will receive your user text when they invoke help for that particular field (they will no longer receive the system text).

Administration for the Con-nect Help System

To maintain system and user texts, you must invoke HMENU in library SYSCNT2H.

  11:52:14              *****   C O N - N E C T    *****               14/02/94
  User ID LS                       H E L P                      Library SYSCNTH 
                                                                                
                            Code Function                                       
                            ---- -------------------                            
                             A   Add                                            
                             M   Modify                                         
                             D   Display                                        
                             C   Copy                                           
                             R   Rename                                         
                             E   Erase                                          
                             P   Print                                          
                             U   Unload (Workfile 3)                            
                             L   Load   (Workfile 3)                            
                             F   Facilities-Authorization                       
                             .   Quit HELP System                               
                            ---- -------------------                            
               Function Code _                                                  
                                                                                
      Application ________  Language 1  Field ________________________________  
                           or select by Topic _______________                   
   to Application ________  Language _  Field ________________________________  
            Mark _ to replace      Mark  _ for System text                      
                                                                                

Note:
The term "application" in the above map refers to the library, i.e. you must enter the source and target libraries in these fields.

The following function codes are available:

A Add
M Modify
D Display
C Copy
R Rename
E Erase
P Print
U Unload (batch)
L Load (batch)
F Facilities - Authorization

At the beginning of each session, you must specify whether you want to work with system texts or user texts. To do so, you must mark the appropriate field of the help menu (X for system texts; if you want to specify user texts, you must type a blank character). However, if you do not specify the text type, you will be prompted to enter this information in a window.

You are not required to specify this information for function F which is only used for user authorization. Thus, the window will not appear when you do not mark the field mentioned above.

When you add a new authorized user with function F, you must always specify the library in which the user is allowed to use PF2; this is the library in which the online Con-nect has been installed. When you display or erase authorized users, you must also specify the library.

When you modify system texts, bear in mind that your modifications will be overwritten with future Con-nect releases.

When you copy texts from one library to another, and if the new texts are to replace old texts, mark the appropriate field in the last line of the help menu. This information also applies to the Rename function. With the Unload and Load functions, the old texts are always replaced with the new texts.

The Con-nect help system always uses workfile 3.

The help system expects the following input (functions U and L can only be used in batch mode):

  A M D C R E P F U L
Source library x x x x x x x - x x
Source language x x x x x x x - x x
Source field x o o o x o o - o o
Source topic - o o o o o o - , ,
Target library - - - x o - - - o o
Target language - - - o o - - - o o
Target name - - - o x - - - , ,
Replace - - - o o - - - ** **
Text type* x x x x x x x x x -
* The text type must be specified only once per session. As a rule, you specify an X (system texts) or a blank character (user texts). This information is always required for function U which runs only in batch mode; you must either specify an X or a comma.
x Mandatory - you must enter information in this field.
o Input in this field is optional.
, Batch mode - you must specify commas as delimiters.
** Always filled in batch mode, i.e. the old texts are always replaced with the new texts.
- Any input in this field will be ignored.

Summary

Functions M, D, C, E, P

If neither source field nor source topic are filled, all texts can be processed.

Function C

As the target information, only the specification of the target library is mandatory. If there is no further target information, all other data will be taken over from the source information.

Function R

As the target information, you can optionally specify another library or language.

Caution: The Rename function moves information from the source destination to the target destination (it does not copy the information). Thus, when you specify another library, the text will no longer be found in the source library; when you specify another language, the previous language will no longer be found in the source library.

Functions U, L

With function U all delimiters must be present, since the tenth parameter decides which text type (system texts or user texts) is to be processed.

Function L loads all texts as specified in the workfile.

Examples for Batch Mode

All English system texts are unloaded from source library SYSCNT2 to the workfile. TSTCNT2 indicates the library name and 1 indicates the language (English). The last parameter (X) indicates system texts. This would be coded as follows:

SYSCNT2H 
HMENU
U,SYSCNT2,1,,,TSTCNT2,1,,,X

The system texts from the previous example are loaded from the workfile into library TSTCNT2. The language code is 1. Existing texts will be overwritten. This would be coded as follows:

SYSCNT2H 
HMENU
L,TSTCNT2,1

The Icelandic (language code 7) user texts for all maps and fields starting with the character M are unloaded from the source library SYSCNT2 to the workfile. TSTCNT2 indicates the library name and H indicates the language. This would be coded as follows:

SYSCNT2H 
HMENU 
U,SYSCNT2,7,M*,,TSTCNT2,H,,,,

The user texts from the previous example are loaded from the workfile into library TSTCNT2. The language code is H. Already existing texts will be overwritten. This would be coded as follows:

SYSCNT2H 
HMENU
L,TSTCNT2,H