insertion point name
The returned screen contains the standard MAGEC proforma code for the nnnnnnnn insertion point, with a message at the lower-right of the screen to "Press PF4 for menu of NAMED PROFORMAs".
Pressing PF4 will take you to a 4-up menu of the named proforma members available. Place the cursor on the name of the (cont.)
proforma member you wish to copy in and press ENTER. You will be returned to the ALGADD screen with the key unchanged, (cont.)
but the text of the screen now contains the proforma member you selected. If the proforma member selected is not the (cont.)
one you want, press PF4 to return to the proforma menu to repeat the selection process.
In the example we used above with the ALGADD function, when you pressed PF4, the sequence of the named proforma menu (cont.)
was by modifier within insertion point name. For a more specific proforma retrieval, follow the example (cont.)
below:
ALGADD sss/nnnnnnnn/SQL
where:
sss
= any valid mask (screen header) number
nnnnnnnn
= insertion point
When the standard MAGEC proforma is displayed on the screen, press PF4. You will now notice a difference in the (cont.)
sequencing of the member names on the menu. All named proforma members with "SQL" in the first characters of the (cont.)
modifier appear at the front of the menu, in member name order. This technique will work when the modifier portion of (cont.)
the custom algorithm's key begins with DLI, SQL, SUPRA, or DATACOM.
Once you have selected the desired member from the proforma menu and returned to the ALGADD screen, you may over-key (cont.)
any portion, if needed, and press ENTER to add the code to the custom algorithm shown in SKEY. You can then make more (cont.)
changes, if desired, to the custom algorithm code. The original named proforma member remains (cont.)
unchanged.
##
PROxxx Functions
The same rules and features apply to online maintenance and access to named proforma members as to ordinary library (cont.)
members, except that the function codes used begin with PRO... instead of LBR... and the only valid page number is 000 (cont.)
(blank defaults to 000). For example, to see the named proforma code used to insert a segment into a DL/I database, (cont.)
enter:
PROSEE INSERT/DLI
Since all named proforma members contain only one page, some restrictions apply to the PRONXT function code. PRONXT is (cont.)
used only when "$GBL" is entered in the PASSWORD field (with sufficient authority) during a global scan. For additional (cont.)
information refer to the global scan section of the online maintenance chapter.
##
Valid PROxxx Functions
All valid PROxxx functions are listed below:
PROADD -- add a page of named proforma code
PROCHG -- change/update a page of named proforma code
PRODEL -- delete a page of named proforma code
PRODUP -- duplicate a named proforma member
PROLOC -- locate a specific page of named proforma code
beginning with the key entered
PRONXT -- used only for global scans
PROSEE -- see/display a specific page of named proforma code
#
Using Other Text Editors
You can use your own shop's text editor (ICCF, ISPF, VOLLIE, CONDOR, etc.) rather than the one that comes with MAGEC, (cont.)
if you prefer. Code on the MAGEC Librarian can be transferred to your text editor for changes, and back to MAGEC using (cont.)
the MAGEC utilities provided. You can use the MAGECLBR utility program with the following control card to copy a member (cont.)
from the MAGEC Librarian to the DOS punch queue or to an OS data set or PDS:
-MAGECPUN ttttnnnnnnnn/mmmmmmmm
where:
tttt =
mask (screen header) number or member type
("LIB ", "DEF ", "PRO ", nnn, or nnnB)
nnnnnnnn =
insertion point name
mmmmmmmm =
the modifier
The "punched" member will have a -MAGECREP control card in front of it so that, after you have finished editing it, you can use MAGECLBR to return (replace) it to the MAGEC Library.
For additional details see the Offline Utilities section in this chapter and also the MAGECLBR section in the "Offline Utilities" chapter (Chapter 9).
#
Appendix A -- Library Functions
##
LBRxxx Functions
LBRADD -- add a page to an ordinary library member
LBRCHG -- change (update) an ordinary library member
LBRCPY -- copy and rename an ordinary library member
LBRDEL -- delete a page from an ordinary library member
LBRDUP -- duplicate from an ordinary library member
LBRLOC -- locate/list all ordinary library member pages
beginning with the key entered
LBRLST -- list all ordinary library member names
beginning with the key entered
LBRNXT -- display the next page of an ordinary library member
LBRPRT -- print a librarian member
LBRPUR -- purge (delete) an entire ordinary library member
LBRSEE -- see/display a page of an ordinary library member
##
ALGxxx Functions
ALGADD -- add a page of custom algorithm code
ALGCHG -- change/update a page of custom algorithm code
ALGCPY -- copy all custom algorithms for one screen header
number to another
ALGDEL -- delete a page of custom algorithm code
ALGDUP -- duplicate a page of custom algorithm code
ALGLOC -- locate a specific page of custom algorithm code
beginning with the key entered
ALGLST -- list custom algorithm members by screen number
beginning with the screen number entered
ALGNXT -- display the next page of a custom algorithm member
ALGPUR -- purge/delete all custom algorithms for a screen
ALGSEE -- see/display a specific page of a custom algorithm
##
RULxxx Functions
RULADD -- add a page of business rule code
RULCHG -- change/update a page of business rule code
RULCPY -- copy all pages of business rule code to
another element
RULDEL -- delete a page of business rule code
RULDUP -- duplicate a page of business rule code
RULLOC -- locate a specific page of business rule code
beginning with the key entered
RULLST -- list names of business rules
RULNXT -- display the next page of business rule code
RULPUR -- purge/delete all pages of code for RULWORK, RULDELT,
and RULPROC for a business rule
RULSEE -- see/display a specific page a business rule
RULUSE -- see uses of a business rule
##
DEFxxx Functions
DEFADD -- add a page of default algorithm code
DEFCHG -- change/update a page of default algorithm code
DEFDEL -- delete a page of default algorithm code
DEFDUP -- duplicate a page of a default algorithm member
DEFLOC -- locate a specific page of default algorithm code
beginning with the key entered
DEFNXT -- display the next page of a default algorithm member
DEFSEE -- see/display a specific page of a default algorithm
##
PROxxx Functions
PROADD -- add a page of named proforma code
PROCHG -- change/update a page of named proforma code
PRODEL -- delete a page of named proforma code
PRODUP -- duplicate a named proforma member
PROLOC -- locate a specific page of named proforma code
beginning with the key entered
PRONXT -- used only for global scans
PROSEE -- see/display a specific page of named proforma code
#
Appendix B -- MAGECLBR Control Cards
The MAGECLBR control card specifies which operation is to be performed and provides the parameters necessary for the desired operation. The control card format is:
Col 1-10:**
Operation (required).
-MAGECADD
Add a member.
-MAGECREP
Replace a member.
-MAGECPCH
Punch and print a member.
-MAGECPUN
Punch and print a member.
-MAGECPRT
Print a member.
-MAGECLST
Print a member.
-MAGECDEL
Delete a member.
-MAGECIDX
Print an index list.
-MAGECUSE
Print "Where-used" report.
**Col 11-14:**
Key prefix (required).
LIB
Ordinary library member.
DEF
Default algorithm.
nnn
0xx
9xx for MMP custom algorithm.
nnnB
0xxB
9xxB for MBP custom algorithm.
DOC
Documentation on DOC file.
DIT
Data items in dictionary.
PRO
Named proforma member.
DEF
Default algorithm code
RUL
Business rule code
Col 15-22:
Member name (ALG file only).
xxxxxxxx
ALG member name.
Col 23-23:
Separator (ALG file only).
/
,
b (blank)
Col 24-31:
Name modifier (ALG file only).
xxxxxxxx
Optional suffix for member name, 1-8 characters.
next: libr07.md.txt