Home

Translated by WordPort from WordStar 3.x - 7.0 document

1. O MSID Th MSID field specifies the 1 to 4 character name of the DBControl system that LOCO is to connect to issue the DBControl commands found in the ACTION key words ACTION The action field contains the DB Control command that is to be issued when the character string specified in the text field is entered as a LOCO command The ACTION filed can be repeated as many times as needed TRACE TRACE Y will cause the DBCTCMD to create a NETEC internal trace while executing the command This parameter overrides the default trace setting which is determine by checking to see if trace is active in the LOCOMAIN task If this parameter is omitted tracing activity will default to the current trace status of the LOCOMAIN task MAXRC This is the maximum return code that is allowable between actions commands If the MAXRC value is exceeded further ACTIONS will be bypassed The default value is 0 PSBNAME This field contains the PSBNAME to be used when issuing commands to the IMSID DB Control system The default value is DBC9000 RESPONSE This field specifies as to whether or not to wait for a positive response to commands specified in LOCO Proprietary Product of NETEC International Inc Copyright 2004 Page 91 Logical C
2. CPUID The cpuid is a four digit value representing the internal MVS id of the cpu It is a filter keyword STARTUP actions will only be performed when LOCO is invoked on that particular cpu The CPUID value may contain wildcard characters The Filter condition may be reversed by preceding the cpu id value by the minus symbol E G CPUID CPUA LOTIME The time is in the format of HH MM SS and represents a clock value It is a filter keyword STARTUP actions will only be performed on or after that particular time of day HITIME The time is in the format of HH MM SS and represents a clock value It is a filter keyword STARTUP actions will only be performed on or before that particular time of day Note HITIME and LOTIME may be specified together to define a time range Proprietary Product of NETEC International Inc Copyright 2004 Page 58 Logical Console Operator User Manual 11 12 05 DATE LODATE HIDATE Note WEEK DAY The MM date must will DD YYYY on The MM wil on date The date must follow the exact format MM DD YYYY y be date must DD YYYY fol fol Ow isa fil Ow is a fil the the exact format ter keyword performed on that particular date exact format ter keyword START It is a filter keyword
3. COMMANI text ACTION text required WAITIME time optional WAITEXT text optional RESET time optional SET UV nn text optional ACTION The text is either an MVS command or a LOCO built in command The ACTION keyword may be repeated on the COMMAND statement At least one ACTION must be coded The ACTION text may contain global Svars for real time substitution WAITIME The time is of the format HH MM SS and represents an amount of time not a clock value A WAITIME may be coded after an ACTION causing a wait for that amount of time before proceeding to the next ACTION WAITEXT The text is any string of characters including the WILDCARD A WAITEXT may be coded after an ACTION causing a wait until that text string is issued as a WTO through the MVS system After the text is seen as a WTO the next ACTION is performed Note Both WAITIME and WAITEXT may be coded between ACTIONS In that case the second ACTION will be performed as soon as EITHER wait condition is satisfied The wait keywords are functionally connected by a logical OR operator RESET The time is of the format HH MM SS and represents an amount of time not a clock value A RESET may be coded only after a WAITEXT and specifies an amount of time after which LOCO is to automatically terminate the WAI
4. ten Check that xxxx is defined in the current IEFSSNxx member of SYS1 PARMLIB on the cpu you are using Check that an IPL of the cpu you are using has been performed since the subsystem name xxxx was defined in IEFSSNxx XXXXCVT IS NOT ESTABLISHED XXXXCVT is built by program module LOCOINIT at IPL time Either LOCOINIT was not specified as the initialization program in IEFSSNxx for subsystem name xxxx or it failed to run correctly at the last IPL Program module must be available in a LNKLST library Check the console log at the time of the last IPL for Message xxxx700 If not found look for other messages in the range of xxxx701 thru xxxx799 e information on which will giv LOCOINIT Also look for any MVS mes a failure of d Sages relat to program LOCOINIT f no pertinent messages ar found contact NETEC Technical Support at your earliest convenience FREEMAIN FAILURE LOCOMAIN failed to freemain a LOCOSA LOCOMAIN will shutdown and produce some important trace information on SYSPRINT Retain the SYSPRINT data and contact NETEC Technical Support at your earliest convenience SUPPRESS REROUTE TABLE GETMAIN FAILED There was insufficient storage available in CSA for the suppress reroute table Maximum size of Determin Copyright 2004 cor
5. The RACF commands necessary to define these profiles are RDEFINE FACILITY LOCO QUEUES WTO BROWSE UACC NONE RDEFINE FACILITy LOCO LOCA QUEUES COMMANDS DELETE UACC NONE Proprietary Product of NETEC International Inc Copyright 2004 Page 149 Logical Console Operator User Manual 11 12 05 Hint If no security is required for the LOCO TSO interface create a single generic profile of LOCO with a universal access of READ This will allow all users access to all LOCO subsystems and access to all functions within the LOCO TSO interface Proprietary Product of NETEC International Inc Copyright 2004 Page 150 Logical Console Operator User Manual 11 12 05 Hints Tips Special Techniques and Examples Communicating with CICS from LOCO CICS is capable of accepting transactions from an MVS console via the MODIFY command CICS can also accept MODIFY commands embedded in JCL streams or from ISPF under TSO When the MODIFY commands come from a hardware console they required th following TCTTE entry DFHTCT TYPE TERMINAL X TRMIDNT xxxx X TRMTYPE CONSOLE X CONSLID nn where xxxx is your choice of a four character terminal id and nn is the console id of the particular console as display by the MVS console command D CONSOLES When the MODIFY commands come from a non hardware
6. LCONO0806 xxxx MUST BE TERMINATED BEFORE REVERSE INIT Explanation LOCOINIT found that LOCOCVT for subsystem name XXXX Was marked LOCOUP There is a LOCOMAIN currently in execution for subsystem name xxxx User Response If you really wish to un initialize LCON subsystem xxxx then terminate the LOCOMAIN which is using rts LCON0807 xxxx VERSION x x mm dd yyyy REVERSE INIT Explanation This is a confirmation that LCON subsystem xxxx has been has been un initialized by LOCOINIT release x x which was assembled on mm dd yyyy User Response None LCON0810 PARM VALUE TOO LARGE MAX SIZE 79 BYTES Explanation Parm value is too large It may not be longer than 79 bytes User Response Remov xtraneous data from PARM LCONO811 GETMAIN FOR SSCT EXTENSION FAILED Explanation An internal error has occurred User Response Contact NETEC Technical support LCON0812 SUBSYSTEM WAS FOUND INITIALIZED WITH LOCO RELEASE x x Explanation An attempt has been made to initialize the LOCO subsystem but the subsystem interface is already initialized with LOCO release x x User Response Run a REVERSE initialization to deactivate the current subsystem initialization and then attempt to reinitialize the subsystem LCON0813 THE SUBSYSTEM IS
7. x Q00S0000 EFINE CARDSIZE 72 QABIBABA PREFIX 00100000 QLIMIT 21 00110000 SLEEP 0 00 00 00120000 WILDCARD 00130000 Sa x 00140001 STARTUP 00150000 ACTION K E D L 1 00160201 WAITTIME 08 01 00 00170001 ACTION K A NONE L 1 001820201 WAITEXT WAITTEXT 00190001 RESET 02 00 00 00200001 ACTION K A NONE L 2 002 10001 C08 1 12 15 Connected to host 10 1 1 20 m 11 57 AM Proprietary Product of NETEC International Inc Copyright 2004 Page 115 Logical Console Operator User Manual 11 12 05 Editing a LOCO Table The following screen will be displayed when a E is entered in front of a member name in the manipulate LOCO tables member name list The LOCO table will be displayed using standard ISPF editor Normal ISPF edit keys are active during this session The user can scroll up and down in the selected table making modifications as needed If the user has modified the table and entered the END command the LOCO compilation process will be automatically invoked The CANCEL command will terminate the edit session without saving any table modifications and return to the manipulate LOCO Tables member list screen CDDF5100_MANUAL EXTRA Personal Client E lel x File Edit View Tools Session Options Help rini NETEC LOCO33 TABLESCTESTTABL COLUMNS 001 00072 COMMAND gt _ SCROLL gt CSR KKXXWX KKKKK
8. PGM IEBGENER SYSOUT SYSOUT DSN your source pds amp M DUMMY PEND PRINT MEMBER SAMPLE PRINT MEMBER SAMPLE2 PRINT MEMBER SAMPLE3 PRINT MEMBER SAMPLE4 PRINT MEMBER SAMPLED5 PRINT MEMBER SAMPLE6 PRINT MEMBER SAMPLE7 PRINT MEMBER SAMPLE8 PRINT MEMBER SAMPLEY PRINT MEMBER SAMPLE10 Proprietary Product of NETEC International Inc Page 33 Logical Console Operator User Manual 11 12 05 Step 9 Define LOCO Control Table for use at your installation Copyright 2004 If this is a new installation of LOCO you will want to create and build a set of LOCO Control tables for your installation Use the tables printed in step 7 as examples The easiest way to accomplish this task is to use the standard ISPF editor to create source for a new LOCO table After the initial LOCOBLDR execution the table will be editable via the LOCO TSO interface If you are upgrading LOCO from a previous release it will be necessary to execute LOCOBLDR against all of your current tables Proprietary Product of NETEC International Inc Page 34 Logical Console Operator User Manual 11 12 05 Step 10 Optionally add LOCO to the installation s MVS Automatic Restart Manager ARM policy LOCO is available for automation restart by the MVS Automatic Restart Manager When
9. LCON0102 NOT ABLE TO OPEN TABLE FILE Explanation Probably missing DD card for ddname TABLE User Response Supply missing DD card LCON0103 NOT A LCON TABLE Explanation The member specified in the PARM to LOCOMAIN or in the LOAD command is not an LCON object table User Response The program module LOCOMAIN will only process LCON tables compiled by the program module LOCOBLDR LCON0104 NOT ENOUGH REGION SIZE FOR TABLE Explanation The member specified in the PARM to LOCOMAIN or in the LOAD command requires a larger REGION than provided User Response Increase the REGION size on the JCL EXEC statement compiled by the program module LOCOBLDR Proprietary Product of NETEC International Inc Copyright 2004 Page 167 Logical Console Operator User Manual 11 12 05 LCONO105 Explanation User Response LCON0106 Explanation User Response LCONO0107 Explanation User Response LCONO108 Explanation User Respons IS NOT A XXXX DEF N 1 D SUBSYSTEM IEFSSN The subsystem name xxxx from the PARM SSN xxxx is not defined as a subsystem to MVS st be defined in member mu SYS1 PARMLI IPL B Check that xxxx is actually the LCON subsys name you wish to use IEFSS Nxx of The name xxxx and must be made known to MVS by an
10. LOCOMAIN release n Insure that the LOCO release number as the LOCOMAIN program XXxx IS NOT AN APPROVE LOCOMAIN was requested subsystem name xxxx b u subsystem names allowed by the LCON system Change the SSN xxxx parameter to specify one of the approved LCON subsystem names SSCT GETMAIN FA LED LOCOMAIN was requested to QUICK START an LCON was unable SSCTcontrol block Attempt to run LOCOMAI N in a larger region to obtain the required storage for error persists Proprietary Product of NETEC International Inc Page 174 TT number than the LOCOMAIN DR program is the same the LOCOMAIN program NUMBER NOT MATCH LOCOMAIN t the xxxxCVT created by program ase number than the umber NIT program is the same D LCON SYSTEM NAME to QUICK START an LCON with t xxxx is not one of the and the contact NETEC Technical Support Logical Console Operator User Manual 11 12 05 LCON0139 Explanation User Response LCON0140 Explanation User Response LCONO141 Explanation User Response LCON0142 Explanation User Response LCON0143 Explanation User Response LCON0144 Explanation User Response LCON0145 Explanation User Response Copyright 2004 SSVT GETMA LOCOMAI N FA LED N was requested to QUI CK START an LCON and was unable to
11. LOCO xxxx SSI to access to LOCO subsystem LOCO xxxx TRACES to allow access to change traces XXXX The one to four character LOCO subsytem name Proprietary Product of NETEC International Inc Copyright 2004 Page 122 Logical Console Operator User Manual 11 12 05 Activating Deactivating Holding and Releasing Resources The following screen is displayed when option 4 is entered from the selection menu The screen allows the user to start and stop LOCO internal traces J CDDF5100_MANUAL EXTRA Personal Client p 12 x isum Logical Console Operator TSO Operator Interface Activate Deactivate Hold Release LOCO Resources Command gt TIME is currently Active Enter A ctivate D eactivate Released H old R elease WTO is currently Active Enter A ctivate D eactivate WIOR is currently Active Enter A ctivate D eactivate EVENT is currently Active Enter A ctivate Deactivate A licensed proprietary product of NETEC International Copyright 2002 00 3 07 06 Connected to host 10 1 1 20 3 11 10 AM From this screen the user can activate deactivate hold and release LOCO resources When LOCO resources are deactivated they are ineligible to be triggered for execution This screen gives the user the ability to manipulate entire LOCO queues The following describes the fields on this screen TIME is currently gt Activ
12. condition is satisfied Proprietary Product of NETEC International Inc A WA not a clock value a wait until through the MVS the next ACT that system ON is performed text s A WAII ON Ihe time is of the format HH MM SS and represents an ME may be ON causing a wait for that amount of the next ACTI characters TEXT may be coded after an ACTI tring is issued as a including the ON After the text is seen as If both are coded will be performed as soon as EITHER wait Both WAITIME and WAITEXT may be coded between ACTIONS the second ACTION The wait keywords are Page 59 Logical Console Operator User Manual 11 12 05 functionally connected by a logical OR operator RESET The time is of the format HH MM SS and represents an amount of coded only tin ne after WA SVARS SUV 32 SVAR label All text fol other global vars and bl ITEXT wit time not a clock value A RESET may be after a WAITEXT and which LOCO is to aul Specifies an amount of tomatically terminate the thout executing any of the following ACTIONs SET SET is an ACTION keyword The symbol must used to insert values into user There are 32 user vars labeled SUV 1 SUV 2 immediately follow the user llowing the symbol including lanks will become the current value of the target u
13. REPEAT opera When LOCOMAI freemained Copyright 2004 TEXT queue for a WTO R If a match is found the filter operands are lter fails the state ment is placed back on If the filter passes q ueue text or COMMAND queue for a the ACTIONs are order with MVS commands being processed by SVC 34 che ch e c m to expir n tatement on the TI reached which ACTIONs of th is placed back on TI d N is requested to shutdown through a LOCO STOP command or a MVS CANCEL or STOP command LOCOMA is beyond curren e time statement have been processed N is posted by the expiration of the stimer ME queue is processed until one is t time of day ME queue at ly f a is placed on TIME operand If a WA the ACTIONs of the When all ave been processed the statement is placed back on its each When all the the statement a time of day determined by the all CSA area is N then gracefully terminates Proprietary Product of NETEC International Inc Page 13 Logical Console Operator User Manual 11 12 05 Functional Diagram Operating System handles messages commands requests timer services and WTOs WTPs Console TIME Psuedo LEONS jobstep direct post WTORs Commands WTOs pseudo WTOs Standard systems and sub systems exits interrogate SYSTEM EXITS message cont
14. day or the occurrence of external events such as of specific WTOs This function of LOCO requires that the user be licensed for the NETEC CAFC product for CAFC functions and the NETEC recognition DBCTL product for DB Control functions The following is an example of a LOCO table that will cause CAFC or DBCTL events Example In this example the user wants to automatically ask CAFC to close the CICS files QAFCTO1 and QAFCTO2 in the CICS99P region and close the Cl at 01 00 pm every day CS file QAFCTO3 in the CI CS99T region The CAFC control file dsname for CICS99P is NETEC VSAM CAFCA4300 AFCF0O01 and the dsname for the CICS99T control fi The user also wants to le is NETEC VSAM CAFC4300 AFCFOO1 start the DI21PART database when the control with job name DBCTL IMS message DFS995I WARM START COMPLETE is issued by the DB 5 00010000 00020000 PRODUCTION LOCO TABLE 00030000 p 00040000 ki 00050000 DEFINE CARDSIZE 72 00060000 PREFIX 00070000 QLIMIT 200 00080000 SLEEP 00 00 00 00090000 WILDCARD 00100000 00180001 ib 00190001 CAFC COMMAND CONSTRUCTION 00200001 b 00210001 i 00220001 CAFCCMD GCAFCOO1 00230001 CTLFILE CICS99P NETEC VSAM CAFC4300 AFCF0001 00250010 CTLFILE CIC
15. NVALID IEBUPDTE CONTROL CARD ENCOUNTERED An invalid ADD or REPL control card has been found in the sequential input to a LOCO import export utility IMPORT command Correct the error and submit the job for execution IEBUPDTE CONTROL CARD MISSING A LOCO import export IMPORT command is being processed with sequential input from the INDD or INDSN keyword The input must contain valid ADD or REPL control cards No such cards were encountered Correct the error and submit the job for execution MEMBER mmmmmmmm NOT IMPORTED MEMBER WAS FOUND AND REPL The member mmmmmmmm was not imported because member mmmmmmmm was found in the TABLEDD or TABLEDSN and replace was not specified either via a REPL control card or the REPLACE option on the MEMBER keyword Correct the error and submit the job for execution Proprietary Product of NETEC International Inc Page 204 Logical Console Operator User Manual 11 12 05 LCON09621 Explanation User Response LCON09631I Explanation User Response LCON0964E Explanation User Response LCON0998E Explanation User Response LCONO999I Explanation User Response Copyright 2004 NVOK NG LO CO TABLE BUI L DER FOR MEMBER mmmmmmmm This is an information
16. WA TEXT Correct a spel ROUTE REROUTE the invalid keyword ling error or a missing continuation indica LCON BU LDER VERS ON X X X X is the LCON release number SUPPRESS This is most likely tor on the previous line mm dd yyyy mm dd yyyy is the assembly date of the program module LOCOBLDR None Proprietary Product of NETEC International Inc Page 159 Logical Console Operator User Manual 11 12 05 LCONOO005 Explanation User Response LCONO006 Explanation User Response LCON0007 Explanation User Response LCONOO08 Explanation User Response LCONO0009 Explanation User Response LCONO010 Explanation User Response LCONO011 Explanation User Response Copyright 2004 OPERAND VALUE IS NULL No value was specified for the operand Provide the proper value for the operand SYSIN FILE IS EMPTY An end of file was found on SYSIN on the first read Change the SYSIN DD JCL to reference an LCON source control table CARD IS EMPTY A blank card was encountered Change the blank card into a comment by placing an asterisk in column 1 KEYWORD IS NULL The statement syntax checker xpected to find an operand keyword but found a left parentheses instead Place the appropriate keyword before the left parentheses
17. Determin LOCOMAIN LOCOSSSM The LOCO LOAD FAI subsystem has attempted to load the LED why the GETMAINED failed and restart LOCOSSSM program and an error has occurred User Respons LCON0820 Explanation User Response LCON0821 Explanation User Respons Determin LOCOMAIN SIZE OF MODULE IN BLDL L ST IS ZERO why the load failed and restart The LOCO subsystem found the size of the LOCOSSSM module to be zero in the BLI module DL entry for the Contact NETEC Technical Support LOAD OF THE LOCOSSSM MODULE HAS FAI LED The LOCO subsystem has attempted to load the LOCOSSSM module and the load has failed Determin Copyright 2004 LOCOMAIN Proprietary Product of NETEC International Inc why the load failed and restart Page 195 Logical Console Operator User Manual 11 12 05 Messages from LOCOIMEX LCONOOO001 Explanation User Response LCONO9001 Explanation User Response LCON0902E Explanation User Response LCONO903E Explanation User Response LCONO09041 Explanation User Response LCONO905E Explanation User Response Copyright 2004 LCON0900 LCON0999 LOCO TABLE IMPO
18. IPL time tasks UNIT and VOL operands must be specified on the JCL DD statements The following JCL PROC may be used to run a pre JES LOCO STARTUP PROC P MEMBER LOCOIPL SSN LCOH IEFPROC EXEC PGM LOCOMAIN PARM amp P E REGION 4M TIME 1440 DPRTY 15 15 STEPLIB DD DISP SHR DSN your loco loadlib UNIT nnnnn VOL SER vvvvvv TABLE DD DISP SHR DSN your loco table library UNIT nnnnn VOLSER vvvvvv The COMMNDOO member of SYS1 PARMLIB would contain COM S STARTUP SUB MSTR to invoke the LOCO proc There will be an error message issued for missing DD cards for SYSPRINT and INTRDR ignore these messages This startup LOCO may not submit job streams since there is no INTRDR JCL to support job submission but it can start tasks The LOCO table member LOCOIPL could look something like STARTUP ACTION S JES2 ACTION S RMF ACTION S VTAMNET ACTION S TSO ACTION S UCC11 WAITIME 00 00 30 Copyright 2004 Proprietary Product of NETEC International Inc Page 152 Logical Console Operator User Manual 11 12 05 ACTION S LOCO2 ACTION STOP LOCO2 is the normal post JES LOCO which would have the full JCL for SUBMIT NTRDR and SYSPRINT SLEEP verses WAITIME Ihe SLEEP operand
19. DSN GDDM SADMMOD ISPPLIB DD DISP SHR DSN you ispf ispplib Addition of ISPPLIB DD DISP SHR DSN SYS1 LOCAL ISPFPNLS DD DISP SHR DSN ISP SISPPENU DD DISP SHR DSN SYS1 DFOPLIB ISPSLIB DD DISP SHR DSN ISP SISPSLIB UNIT 3390 VOL SER Z1RES1 DD DISP SHR DSN GIM SGIMSENU UNIT 3390 VOL SER Z1RES1 ISPTLIB DD DISP SHR DSN ISP SISPTENU UNIT 3390 VOL SER Z1RES1 DD DISP SHR DSN SYS1 DGTTLIB UNIT 3390 VOL SER Z1RES1 Proprietary Product of NETEC International Inc Copyright 2004 Page 28 Logical Console Operator User Manual 11 12 05 b Modify your ISPF primary appropriate panel Program The fol executed as a result modified primary op your ispf panel To locate your primary op to include the LOCO TSO Llowing panel of being selected tion panel library PRI option panel or other Interface definition should be An example is found in MOPT tion panel examine the TSO procedure and find the SPPI B DDNAME Ihe ISR PRIM member default name for be found in one of for this DDNAME the default ISPF primary before modification slightly different that been indicated below the first The following is a partial the primary option member will concatenations of libraries listing of tion panel furnished my IBM Op The panel you find may be this
20. MSG Copyright 2004 This paramet wil ll wait to acquire an EXCI ter can be used to modi attempting specified as EXCIT 30 seconds see the CICS Appl Instal This paramet lation Manual to acquire the session ME hh mm ss For a ication File Cont the CICS App Manual fy the time again The The default rol Facility The format For a complete lication that LOCO receive session before time is value is complete description of this parameter ter can be used to modify the number of EXCITIME int tervals that will be al a message will be issued indicating that waiting for EXCIMSG 03 seconds i e a receive session issue a messag 90 seconds For ac lowed to befor xpir LOCO has been The default value is very 3 intervals of 30 omplete description of Proprietary Product of NETEC International Inc Page 88 Logical Console Operator User Manual 11 12 05 CONNTYPE this parameter s the CICS Application File Control Facility Installation Manual RC SESSION This parameter can be used to modify the default connection type Specify L for LU 6 2 or E for EXCI The default value is CONNTYPE L for LU 6 2 For a complete description of this parameter s the CICS Application File Control Facility Installation Manual This parameter is used to specify if th
21. Proprietary Product of NETEC International Inc Page 62 Logical Console Operator User Manual 11 12 05 condition is satisfied The wait keywords are functionally connected by a logical OR operator RESET The time is of the format HH MM SS and represents an amount of time not a clock value A RESET may be coded only after a WAITEXT and specifies an amount of time after which LOCO is to automatically terminate the WAITEXT without executing any of the following ACTIONs SET SET is an ACTION keyword used to insert values into user SVARS There are 32 user vars labeled SUV 1 SUV 2 SUV 32 The symbol must immediately follow the user SVAR label All text following the symbol including other global Svars and blanks will become the current value of the target user Svar preceding the symbol Proprietary Product of NETEC International Inc Copyright 2004 Page 63 Logical Console Operator User Manual 11 12 05 WTO Statement The text is any string of characters This statement delineat including the WI S an action or series of action LDCARD s to be performed by LOCO whenever a WTO is issued through the MVS system matching the coded text ACTI ON SUPPRESS DELETE text ACTION text SUPPRESS DELETE REROUTE routes LOTIME time H I ME time DATE date LO HI
22. IMS 6 1 1IMS 5 1 IMS 5 1 modified to add the LOCO The SVC number that was selected for the LOCO SVC IMS 4 1 IMS 4 1 LOCO ATH CICS 6 2 CICS 6 2 IMS 6 1 IMS 6 1 IMS 5 1 IMS 5 1 laced in the MVS LPA be done my making IEALPAxx member in SYS1 PARMLIB The Page 21 Logical Console Operator User Manual 11 12 05 The following is an example of the same IEALPAxx member after additions have been made for the LOCO SVC Note that the library that contains the SVC must be a library that is cataloged in the MVS master catalog INCLUDE LIBRARY SYS1 LOCO LPALIB Addition MODULES LOCOSVC Addition Addition INCLUDE LIBRARY SYS1 CICSTS23 CICS SDFHLPA MODULES DFHCSVC DFHDSPEX DFH99SVC DFHDUMPX DFHIRP An IPL of the MVS system with a CLPA option is now necessary to cause the LOCOSVC module to be placed in the MVS LPA Proprietary Product of NETEC International Inc Copyright 2004 Page 22 Logical Console Operator User Manual 11 12 05 Step 4 Make the LOCOINIT program available at IPL If you chose to authorize the LOCO Library via inclusion in the MVS link list you should skip this step If other authorization methods were selected it is necessary to copy the LOCOINIT program to a link list library The actual library is site dependent For purposes of this example the library is assumed to be SYS1 LINKLIB
23. LOCO statements If LODATE is coded without HIDATE then the range of dates consists of the LODATE value and all future dates f HIDATE is coded without LODATE then the range of dates consists of the HIDATE value and all previous dates In all cases the end points are inclusive Now suppose you have a situation such that you want an LOCO defined event to be triggered only from 10 AM on Friday October 24 until 4 PM on Monday October 27 You might be tempted to code the LOCO statement WTO ABC123 ACTION S TASK23X LODATE 10 24 1999 LOTIME 10 00 00 HIDATE 10 27 1999 HITIME 16 00 00 This statement would appear to span the desired time range However the time range of 10 00 to 16 00 will be check for each individual day within the da the original intent can be obtained little ingenuity te range of 10 24 to 10 27 With a WIO ABC123 ACTION S TASK23X DATE 10 24 1999 LOTIME 10 00 00 WIO ABC123 ACTION S TASK23X LODATE 10 25 1999 HIDATE 10 26 1999 WIO ABC123 ACTION S TASK23X DATE 10 27 1999 HITIME 16 00 00 Here the beginning and ending days are separated as specific DATEs with a beginning and ending tim respectively and the middle days have no time periods NOT CATLGD 2 messages Ihe system message talogued during deal It is not normal and appears on If you wish
24. Note Whenever multiple filter keywords are coded all criteria must be satisfied in order for the actions to be performed The filter keywords are functionally connected by a logical AND operator WAITIME Copyright 2004 Ihe time is of the format HH MM SS and represents an amount of time not a clock value A WAITIME may be coded after an ACTION causing a wait for that amount of time before proceeding to the next ACTION Proprietary Product of NETEC International Inc Page 84 Logical Console Operator User Manual 11 12 05 WAITEXT RESET SET Copyright 2004 The WILDCARD causing WTO a WTO Note system text is any string of characters inc A WAITEXT may be coded after an ACTI a wait until that text s through the MVS luding the ON tring is issued as a After the text is seen as the next ACTION is performed Both WAITIME and WAITEXT may be coded between ACTIONS In that case the second ACTION will be performed as soon as EITHER wait condition is satisfied The wait keywords are functionally connected by a logical OR operator The time is of the format HH MM SS and represents an amount of time time after which LOCO WA event SET is an ACTI user SVARS SUV 2 follow symbol become the user SVAR including other gl not a clock value coded only after a WAI ON k
25. Shorten the MSG text to no more than 80 bytes e subsystem name in the PARM SSN xxxx does not have a LOCOCVT established initialized I I has been run properly for e PARM SSN xxxx specified a subsystem name unknown to MVS xxxx defaults to LCON Insure that xxxx is the proper subsystem name for this LCON Insure that xxxx is defined in IEFSSN in the current SYS1 PARMLIB and that the system has been IPLed since xxxx was defined in IEFSSN NOT ABLE TO OPEN SYSPRINT The open for ddname SYSPRINT failed Insure that there is JCL for ddname SYSPRINT XXXX NOT RUNNI NG The LOCOCVT for LCON subsystem name xxxx is marked LOCODOWN name XXXX Insure that LOCOMAI subsystem name befor Proprietary Product of NETEC International Inc No LOCOMAIN is active for subsystem N is running for the specified xecuting LOCOI NTF Page 184 Logical Console Operator User Manual 11 12 05 LCON0607 Explanation XXXX The L marke STOPPED RUNNI OCOCVT NG for LCON subsyst d LOCODOWN while LOCOI unning for the specified Lem name xxxx was NTF was in execution User Response Insure that LOCOMAIN is r subsystem name befor xecu LCON0608 xxxx LOCOSA GETMAIN FAILED Explanation LOCOINTF was unable to obt LOCOSA User Respons Determin LCON0609 XM POST FAILED Explanation LOCOINTF was unable to POST LOCOMAT User Respons
26. User Response LCON0704 Explanation Issued by User Response LCON0706 Explanation Issued by User Response LCON0707 Explanation Issued by User Response LCON0708 Explanation Issued by User Response Copyright 2004 LCON0700 LCONO0799 CAFC INTERFACE SUBTASK BEGINNING INITIALIZATION This is an information message indicating the LOCOCAFC subtask is beginning initialization LOCOCAFC none CAFC INTERFACE SUBTASK TRACE ACTIVATED This is an information message indicating the LOCOCAFC subtask has activated internal trace LOCOCAFC none CAFC INTERFACE SUBTASK TRACE DEACTIVATED This is an information message indicating the LOCOCAFC subtask has stopped internal tracing LOCOCAFC none CAFC INTERFACE SUBTASK BEGINNING TERMINATION This is an information message indicating the LOCOCAFC subtask is beginning termination LOCOCAFC none CAFC INTERFACE SUBTASK INITIALIZATION COMPLETE This is an information message indicating the LOCOCAFC subtask has completed initialization LOCOCAF C none CAFC INTERFACE SUBTASK TERMINATION COMPLETE This is an information message indicating the LOCOCAFC subtask has completed termination LOCOCAFC none ERROR ALLOCATING CAFC CONTROL FILE a b c d The LOCO CAFC subtask has attempted to all
27. each member member ADD or RE he export PL control If the outpu RE with a the output ith a AD Tf will s tart w end with IEBUPDTE a ENDUP T format control mrmmmmmmm IN wi name asterisk will be DD or imported INI ENI is a PDS each member of data set is PL control cards will ted output should cards between a sequential data DUP control D or REPL he default cards indicates th The member k member name yword is on DSN is a PDS th an asterisk TE imported in all member is not a to member nnnnnnnn in the o REPLACE is not already exist in the LOCO table D or TABLEDSN wil TABLED generic name specifie named members from the input is not card as th control inclu de that is to be ly valid wh The member dicating tha s of the inp i separate e last the PDS card and en the name may terminate t is a generic the member name is specified as a single ut source library PDS If nnnnnnnn is specified and mmmmmmmm member mmmmmmmm will be renamed utpu d LOCO be source l not table tables members that library specified by replaced with identical library LE PDS Proprietary Product
28. o Once the new version of LOCO has been it s tested make the appropriate changes to the system link list to activate the use of the new version Proprietary Product of NETEC International Inc Copyright 2004 Page 18 Logical Console Operator User Manual 11 12 05 Step 3 Determine the authorization technique to be used by LOCO Many of the LOCO programs require APF authorization to function correctly There are two methods to achieve the required authorization LOCO can be executed from an MVS authorized library or a LOCO supplied authorization SVC can be installed at your installation The following contain information about each of these methods Method 1 Authorization of the LOCO program library Either adding the LOCO library to the MVS link list or placing the LOCO library in the authorized library list in SYS1 PARMLIB can authorize the LOCO program library To add the LOCO libraries to the MVS link list the current link list definition usually found in the PROGxx member of SYS1 PARMLIB must be modified The following example shows a partial listing of the link list portion of a PROGxx member before the LOCO library has been added The exact format of the LNKLST card shoul
29. to four character LOCO subsytem name Proprietary Product of NETEC International Inc Page 139 Logical Console Operator User Manual 11 12 05 Displaying and Manipulating the EVENT Queue The following screen is displayed when the user selects the EVENT queue for manipulation 3 CDDF5100_MANUAL EXTRA Personal I Client File Edit View Tools Session Options Help itii reir Logical Console Operator TSO Operator Interface Display Manipulate Event Queue for LOCA Command gt _ Scrol gt CSR _ EVENT ENDOF STEP UNTIL 24 00 00 HITIME 24 00 00 WEEKDAY MTWTFSS JOBTYPE JOB JOBNAME UZTEC8A CPUID NTC1 STEPNAME STEP1 EVENT ENDOFSTEP ACTION EOS ACTION2 _ EVENT ENDOFSTEP UNTIL 24 00 00 HITIME 24 00 00 WEEKDAY MTWTFSS JOBTYPE JOB JOBNAME UZTECBA CPUID NTCI STEPNAME STEP1 EVENT ENDOFSTEP ACTION EOS ACTIONI _ EVENT ENDOFSTEP UNTIL 24 00 00 HITIME 24 00 00 LODATE 2002 085 HIDATE 2002 091 WEEKDAY MTWT SS JOBTYPE JOB JOBNAME MYJOBEVT TSOID UZTECI CPUID NTC1 STEPNAME STEPEVT EVENT ENDOFSTEP ACTION EOS ACTIONI WAITIME 1 0 00 ACTION EOS ACTION2 WAITEXT WAITTEXT3 RESET 01 00 00 6 00 1 03 15 Connected to host 10 1 1 20 11 24 AM From this screen the user can delete hold or release a specific entry on the LOCO EVENT queue Each queue entry is formatted on multiple lines Before the beginning of a queue entry is an action field where the user speci
30. ts are placed on an EVENT queue waiting for notification vent in orde ter all the table statements have been a stimer is issued for the top and the STARTUP queue is processed tement is removed from the queue and the filter ONS are executed r with ONs of the star processed the statement is discarded The LOCO exi the input When LOCOMA matches the text generali from transient da Copyright 2004 ts and interfaces all pass text to LOCOMAI text originates from a WTO R ted by the LOCO pseudo WTO interface ta processor LOCOTDEX IN LOCOINT N receives TEXT from its exits or interfaces to the LOCO table statements on the appropriate Proprietary Product of NETEC International Inc Built in LOCO commands If a WAITEXT operand is encountered placed on the TEXT queue waiting for a ME operand is encountered the table ting for the time to tup statement have been whether a console command or from F or it Page 12 Logical Console Operator User Manual 11 12 05 queue e g console command If the fil validated its original executed in and built in LOCO commands being processed internal ITEXT operand is encountered the table statement ue waiting for a matching WTO table statement is placed on the TIME queue WA the TEXT qu e is encountered waiting for Statement h original que When LOCOMAI LOCO table s
31. ACTIVIVE indicates TIME events are being processed it is set from paused status by ACTIVATE TIME it is set from held status by RELEASE TIME PAUSED indicates TIME events are not being processed it is set by DEACTIVATE TIME HELD indicates TIME events are being held for later processing after RELEASE TIME it is set by HOLD TIME None This message produced by the STATUS command LE TRANSFER SLOTS USED xxxxx OF yyyyy There are yyyyy pointer slots in LOCOCVT used to locate LOCOSA control blocks The slots are used dynamically as LOCOSAs are allocated and freed XXXXX is the high water mark of slot usage None This message produced by the Q8 STATUS command MESSAGES LOST QUEUE FULL XXXXXX XXXXXX Count of WTOs have been lost to LCON due to OLIMIT overflow Consider increasing CLIMIT on DEFINE card It is possible that LOCOMAIN is dispatching too slowly Proprietary Product of NETEC International Inc Page 181 Logical Console Operator User Manual 11 12 05 LCON0185 Explanation User Response LCON0186 Explanation User Response LCON0187 Explanation User Response LCON0188 Explanation User Response LCON0189 Explanation User Response LCON0190 Explanation User Response LCONO191 Explanation User Re
32. Copyright 2004 Page 27 Logical Console Operator User Manual 11 12 05 The following is a partial listing of the ISPFPROC from the previous example after it has been modified to include the LOCO libraries The changes have been indicated below The double dots indicate missing lines of information that have been removed to shorten the listing J RRR RRR KKK KK KK RK I KCKCK I I I kCkC Ck kc k Ck kck k kck ck kck ck kck ck I kk k k K ISPF FULL FUNCTION LOGON PROC LIE J RRR RRR KKK KK KK OR I kkk kkk kkk kkk k kCkC Ck kkk k kkk k kkk k kk ck k k k k kk ISPFPROC EXEC PGM IKJEFT01 REGION 0M DYNAMNBR 175 PARM ISPFCL STEPLIB DD DISP SHR DSN your load pds Addition of LOCO STEPLIB SYSUADS DD DISP SHR DSN SYS1 UADS SYSLBC DD DISP SHR DSN SYS1 BRODCAST SYSPROC DD DISP SHR DSN SYS1 LOCAL CLIST DD DISP SHR DSN ISP SISPCLIB SYSEXEC DD DISP SHR DSN ISP SISPEXEC DD DISP SHR DSN SOMMVS SGOSREXX SYSHELP DD DISP SHR DSN SYS1 HELP DD DISP SHR DSN ISP SISPHELP ISPMLIB DD DISP SHR DSN your ispf ispmlib Addition of ISPMLIB DD DISP SHR DSN ISP SISPMENU DD DISP SHR DSN SYS1 DFOMLIB ISPEXEC DD DIS P SHR DSN ISP SISPEXEC DD DISP SHR DSN SYS1 SBPXEXEC ISPLLIB DD DISP ll n I AJ
33. Correct the error and submit the job for execution Proprietary Product of NETEC International Inc Page 200 Logical Console Operator User Manual 11 12 05 LCON0 934E Explanation User Response LCON0935E Explanation User Response LCON0937E Explanation User Response LCON0938E Explanation User Response LCON0 939E Explanation User Response LCON0940E Explanation User Response Copyright 2004 THE TABLEDSN A B C D MUST BE A PDS The LOCO table data set specified either via a TABLEDD or TABLEDSN keyword must be a PDS Inspection of the data set has found otherwise Correct the error and submit the job for execution THE TABLEDSN A B C D IS NOT A LOCO TABLE LIBRARY The LOCO table data set specified either via a TABLEDD or TABLEDSN must be the format of a LOCO table library Inspection of the data set has found otherwise Correct the error and submit the job for execution REPLACE IS INVALID FOR SEQUENTIAL OUTPUT An EXPORT command is being processed whose output is a sequential file The REPLACE option has been specified on the MEMBER keyword This is invalid Correct the error and submit the job for execution THE LRECL OF THE OUTDD DATASET MUST BE 80 The output data set of a LOCO EXPORT command must have an LRECL 80 Inspection of the data set specified by either th
34. D DDNAME02 files to be opened in CI DNMAEO4 files to be closed in CICS99X when the CS99P and the DDNAMEO3 GCAFCTST commands is issue in LOCO CAFCCMD CAFCTST CTLFILE CICS99P CI DDNAMI DDNAMI 99X CI DDNAMI ACTION 0 D ACTION O D CTLFILE CICS ACTION C D ACTION C D D D D D E01 E02 E03 DDNAMI E04 CS99P CAFC CONTROL FILE CS99X CAFC CONTROL FILE Proprietary Product of NETEC International Inc Page 90 Logical Console Operator User Manual 11 12 05 DBCTCMD Statement This statement delineates a DBControl action or series of DBControl actions to be performed by LOCO whenever the COMMAND text is keyed on the MVS console or encountered as an action of another LOCO command The first character of the text must be the LOCO command prefix as specified on the DEFINE statement The use of the DBCTCMD requires the presence of the NETEC DB Control Batch interface program product The DBControl Batch interface is a separate product that can be licensed from NETEC International DBCTCMI text MSID ims name required ACTION DBControl command required TRACE Y N optional MAXRC number optional PSBNAME name optional RESPONSE WAIT NOWAI optional WAITTIME number optional SUFFIX xx optional
35. Issued by User Response Copyright 2004 UNABLE TO LOAD The LOCO the DB Control DBC2 LOCODBCT NVAL The LOCO LOCODBCT Correct the table LOCODBCT none the LOCO STEPLI Add the library containing the DB CONTROL PROGRAM DB Control subtask batch interface program 000 was not found in the STEPLIB concatenation DBC2000 tempted to load DBC2000 has at DBC2000 program to B concatenation DB CONTROL COMMAND COMPLETE This is an information message indicating the LOCO DB Control subtask is executing command xXxxxxxxx D LOCO QTABLE ENTRY RECE D BY LOCODBCT VE DBCTCMD that did not contain an DBCTCMD command DB Control subtask has encountered a MS D keyword and reload the LOCO D RC EXECUT This NG LOCODBCT none DB CONTROL COMMAN is an information message indicating the LOCO DB Control subtask is executing command xXxxxxxxx D XXXXXXXX TERM NAT NG EXECUT ON OF DBCTCMD DUE TO FORCE REQUEST This is an information message indicating the LOCO execution of a DB Control subtask has interrupted a current DBCTCMD due to an operator action the current LOCO that required a LOAD FORCE of table LOCODBCT none REMOVING DBCT QUEUE ENTRY FROM THE LOCODBCT WORK QUEU
36. LOCOMAIN was started with PARM SSN xxxx but the LCON subsystem named xxxx has not been initialized LCON subsystems are initialized by LOCOINIT at IPL time or alternately by batch execution of program LOCOINIT Insure that xxxx subsystem definition in your current IEFSSNxx member of SYS1 PARMLIB has LOCOINIT specified as the initialization program Insure that your system has been IPLed since IEFSSNxx was updated NVALID WAIT FLAG QFLAG1 The structure of the internal LCON table is incorrect It has been damaged during LOCOMAIN execution Insure that the release levels of LOCOBLDR and LOCOMAIN are the same Recompile the LCON table with LOCOBLDR if the error persists contact NETEC Technical Support INTERNAL READER NOT AVAILABLE LOCOMAIN attempted to open the internal reader file ddname INTRDR but the open failed Insure that the JCL for LOCOMAIN has a proper definition for the INTRDR DD statement Proprietary Product of NETEC International Inc Page 172 Logical Console Operator User Manual 11 12 05 LCONO128 Explanation User Response LCON0129 Explanation User Response LCONO130 Explanation User Response LCONO131 Explanation User response LCON0132 Explanation User Response
37. NG sequence separated by the proper escriptor codes FOR find the end of the es The list should arentheses list by placing a of it RESET MUST BE PRECEDED BY WA TEXT The RESET operand keyword is conjunction with the WAITEXT RESET is to be placed after Correct the RESET WAITEXT op RESET AND WAITIME ARE MUTUAL only used in operand keyword WAITEXT erand keywords LY EXCLUSIVE OPERANDS N THIS CONTEXT RESET and WAITIME may not be terminate a WAITEXT event User Respons LCONO0030 Explanation User Response Copyright 2004 Us ither RESET or WAITIME not both both used to operand keywords but XXXXXXXX SUBSTRING CANNOT BE A variable symbol substring at position 1 or greater Correct the substring expres position GIN A ZERO expression must begin sion beginning Proprietary Product of NETEC International Inc Page 163 Logical Console Operator User Manual 11 12 05 LCON0031 EXPECTED SOME VALUE ON RIGHT SIDE OF SYMBOL Explanation In a SET operand for a user variable the string User Response LCON0032 Explanation User Response LCON0033 Explanation User Response LCON0034 Explanation expression on the right for the symbol was null Provide a non null string expression for the SET operand XXXXXXXX SUBST
38. Page 205
39. Persona I Client pese Logical Console Operator TSO Operator Interface Display Manipulate Command Queue for LOCA Command gt _ Scrol gt CSR _ DBCTCMDCeDBCTOO 1 UNTIL 24 00 00 HITIMEC24 00 00 WEEKDAY MTWTFSS IMSIDCIVP3 MAXRC 16 PSBNAME DBC2000 SUFFIX LD WAITIME Q1 RESPONSE WAIT ACTION START DATABASE DI21PART _ CAFCCMDCeSHUTOO3 UNTIL 24 00 00 HITIME C24 00 00 WEEKDAY MTWTFSS CTLF ILECAAAA NETEC CAFCA300 AFCFOQ01 ACTION AAAA SHUT _ CAFCCMD SHUTQQ2 UNTIL 24 00 00 HITIME C24 00 00 WEEKDAY MTWTFSS CTLFILE SSSS NETEC CAFCA300 AFCF0Q01 ACTION SSSS SHUT _ CAFCCMD eSHUTOOL UNTIL 24 00 00 HITIME 24 00 00 WEEKDAY MTWTFSS CTLF ILE CDDDD NETEC CAFC4300 AFCFOQQ1 1C 01 1 03 15 I Connected to host 10 1 1 20 i 11 25 AM From this screen the user can delete hold release or execute a Specific entry on the LOCO COMMAND queue Each queue entry is formatted on multiple lines Before the beginning of a queue entry is an action field where the user specifies what action he would like LOCO to take against the following COMMAND queue entry The valid actions that can be specified for a queue entry are Action Description H Hold the COMMAND queue entry Prevent LOCO from taking action should actions required to execute this queue entry be meet Proprietary Product of NETEC International Inc Copyright 2004 Page 142 Logi
40. The replace option o invalid Correct the error an execution n the MEMBER keyword is d submit the job for TSO STACK SETUP FAIL An internal error ha initialization phase ED RC XX S occurred during the of the LOCO import export utility while attemp stack Contact NETEC techni INDD The LOCO import expo INDD and INDSN keywo statement These ke and one must be remo Correct the error an execution EITHER INDD OR INDSN Neither the INDD or AND INDSN ARE MUTUALLY EXCLUSI ting to setup the batch TSO cal support VE rt utility has found both the rds on an IMPORT control ywords are mutually exclusive ved d submit the job for S REQUIRED INDSN keyword was found on the LOCO import export u One of the keywords tility IMPORT control card is required Correct the error an execution d submit the job for Proprietary Product of NETEC International Inc Page 197 Logical Console Operator User Manual 11 12 05 LCON0916E Explanation User Response LCONO0917E Explanation User Response LCON0918E Explanation User Response LCON0919E Explanation User Response LCONO 920E Explanation User Response LCON0921E Explanation User Response Copyright 2004 INI DD M SS the job INI
41. WEEKDAY JOBNAME U JOBTYPE U CPUT D cccc DATE date DATE date tfss ue ue mtw val val TSOI ORIG D N tt ttt SLEEP WAITIME value THRESHOLD count time time WAITEXT RESET SET S time UV nn text text The text is one of the two types of commands 1 an MVS command 2 a LOCO built in command Ihe ACT as many times as needed coded The ACTION text Svars for real time s This operand 1 hardcopy log console This operand disappear REROUTE Copyright 2004 codes This operand of the wi on wil l wil l Cause y may conl titution the WTO ill ubs W ON keyword may be repeated At least tain on the WTO statement one ACTION must be global or local not Cause the WTO change the rou original WTO to appear on to be rout complet ted to the any MVS tely ting and descriptor as Rn where n ranges from 1 thro The routing codes ar ugh 128 Proprietary Product of NETEC International Inc keyed descriptor Page 64 Logical Console Operator User Manual 11 12 05 LOTIME codes are keyed similarly as Dn where n ranges from 1 through 16 Multiple routes and descriptors may be keyed in any order separated by co
42. in the LOCOIME X JCL that i or the import process or partitioned mutuall DSNAME o Ltttttt is r partiti utually exclusive with the DDNAME in LOCO table library rce th at is cha Ihe TABLE Ihe TABLE TABLED LUS ive with DSNAME o for the The default is NO y exclusive wi f the data set ocess The oned data set th the LOCOI INI MEX JCL The IN data set th the INDSN to be used DSN can be e The INDSN INDD keywo that i e to be imported t contains LOCO tually exc is the targe DSN must be a P DSN keyword is mu D keyword YES NO indicates that the the SYSLIST data set tables when that is the ta the TABLEDSN f the LOCO tab The TABLED The TABLED for the D must D keywo keyword le library rget source tha DS that conta source is t tually exclusive wi ins LOCO tab th o be listed LIST YES is specified Proprietary Product of NETEC International Inc being the source has s to D can The as ither rd S be a rd is that t is to be imported les he on ys Page 48 Logical Console Operator User Manual 11 12 05 BUI MEMBER Copyright 2004 YES NO indicates that ADD or contain members set the
43. time after which LOCO not a clock value is TEXT and specifies an amount of to automatically terminate the WAITEXT and recycle the LOCO table entry without executing any of the following ACTIO entry will then wait for original WTO text SET is an ACTI user SVARS ON keyword There are 32 user Svars Ns label The table the next occurrence of the used to insert values into ed SUV 1 SUV 2 SUV 32 The symbol must immediately follow the user SVAR label All text following the symbol including other global or local vars and blanks will become the current value of the target user Svar preceding the symbol Proprietary Product of NETEC International Inc Page 67 Logical Console Operator User Manual 11 12 05 MAJOR Command The text is any string of characters including the WILDCARD This statement delineates an action or series of actions to be performed by LOCO whenever a MULTI LINE WTO is issued through the MVS system matching the coded text for both the major text line and the minor text line text MINOR text required MINOR value required ACTION text optional SUPPRESS option DELETE option REROUTE routes option LOTIME time option HITIME time option DATE date option LODATE date option HIDATE date option WEEKDAY mtwtfss option JOBNAME value option JOBTYPE val
44. will only be performed on or before date HIDATE and LOI may the will the set will to 20 The the week beginning with Monday STARTUP actions will tions which contain the character ld cause the STARTUP keyword weekday posi Example WEEK provide range of th ei ther of 00 through 50 if YY is higher than 50 be set to 19 y be performed on or after that par DATE may be specified together not be specified wi above date operands the complet START them EL string of characters represents actions to be performed on Monday only Note WAIT WAITEXT Copyright 2004 ME DAY M W F woul Whenever multiple filter keywords are coded but If any is specified as MM DD YY te YYYY internally then the century will then the century of MM DD YY or STARTUP actions of MM DD YY or UP actions ticular of MM DD YY or UP actions that particular DATE of LOCO is in be YY the seven days of It is a filter NOT be performed on Wednesday and Friday all criteria must be satisfied in order for the actions to be performed The filter keywords are functionally connected by a logical AND operator amount of time coded after an ACTI time before proceeding to text is any string of The WIL DCARD causing WTO a WTO Note
45. DEFINE Statement This stat particular table tement provides LOCO with gl Normally the card of PREFI SLEEP CARDSI ROUTE Copyright 2004 DCARD ZE PREF WIL obal information about this the LOCO table definition IX value DCARD value SLEEP value CARD ROUTE va SIZE number Lues QLIM T number DEFINE statement is the first optional optional optional optional optional optional The value is a single character to be used to identify LOCO commands and distinguish them from MVS or JES This same character must be the first commands character of each defined LOCO command in COMMAND statements NOTE The default is Q Please note that will be inappropriate for LOCO command prefix if your installation uses NCCF In that case pick a different special character for The value represent purposes The time i the LOCO command prefix say 2 Oe is a single character used in text values to The default is s of the format amount of provides a WTO s tatement time not a clock value global default for EE DEFINE sta 0 0 The number determines seconds tement is limi th sta val sequence numbers The values ue would be 72 so that the s Thi ted to a maximum value o
46. Facility 00 00 D sta h time by coding the command lish a session with CI trace setting wh trace is active ter is omitted urrent trace statu The default to create a NETEC This ich is in the tracing s of the CS LOCO the availability of the LU If the end of the list is reached LU name ot busy names the of time befor The wait value specified must be in the The default You may specify an override wait the LUTIME hh mm ss h mm ss cemen r S Installat reprocessing t For a complete the CICS Application ion Manual lue Each The default value is 03 override messag LUMSG nn comp Applica DELAY A tin on the the format of the comp Last lete trol frequency at r keyword on the CAFCCMD statement lete description of this parameter s tion File Cont Facili nd of the LU names list LOCO checks the time the number of uns The without message uccessful t of LUs equals the message LOCO writes a message message lue must be a 2 digit numeric value from 01 You may specify an un time by coding the For a the CICS ty tatement and ne delay may be invoked by en CAFCCMD st CAFC request DELAY parameter i The the r tering the et S description of this parameter s Application Fi
47. In each payroll job stream insert a e places similar to INTE COND 0 GT STEP3 PARM SSN xxxx MSG FAIL PAYROLL STEP 3 The xxxx is the subsystem name you have chosen for LOCO and the corresponding LOCO control table entry would be WTO FAIL PAYROLL ACTION R2 D2 PAYROLL JOB SJOBNAME FA LED N WE RAK ERT ACTION R2 D2 NOTIF Now suppose that in a moment of indiscretion and was fired because of i Y PROGRAMMER DON TELL AT 123 456 7890 Don Tell did tell t In order to update the notify only the second ACTION in messages for the entire payroll system the LOCO control table entry need be changed and phone number of Don Tell s replacement to reflect the name The Pseudo WTO facility has many applications for on line environments It is an efficient interfac and TP control programs such as VTAM NCCF The message that the batch job s 1 on line transactions between batch jobs CICS IMS TSO etc tep posts to LOCO can trigger 2 CICS CEMT commands 3 IMS MTO commands 4 notifications to TSO users outstanding WTOR Batch job con WTORS ar xtremely easy to impl 5 a reply to an nmunications with SCPs that use lement becaus LOCO automatically captures and updates reply numbers for key outstanding WTOR
48. It is a filter keyword WTO actions will only be performed for WTOs from jobs submitted by that TSO user The TSOID value may contain wildcard characters The filter condition may be reversed by preceding the TSO id value by the symbol E G TSOID PC1 The origin is an 8 byte value representing the JES sysid from CTXTSYSN field of the CTXT WTO actions Proprietary Product of NETEC International Inc Page 70 Logical Console Operator User Manual 11 12 05 THRESHOLI SLEEP D The count will only be performed for WTOs from matching origins This filter is particularly useful for JES3 environments Note Whenever multiple filter keywords are coded all criteria must be satisfied in order for the actions to be performed The filter keywords are functionally connected by a logical AND operator be encountered before the ACTION is performed THRESHOLD is reset each The time is of the format amount of time not a clock value cause this represents the number of times the WTO must time the ACTION is performed HH MM SS and represents an This keyword will WTO entry to be dormant for the specified amount of time after it has completed th ntir series of ACTIONS It is effectively removed from the for the time period The default is taken from DEFINE SLEEP statement DEFINEd it
49. LOCO s no nent and operand keywords are interpretive processing is HITS N tructi ns processing is program modul tarted task or as a batch job and value ranges for on path I O is required to access and Each statemen queue depending on the statement tements are placed on a TEXT queue waiting for a to be passed from an LOCO exit INTF le LOCOMAIN t may Initially trol table into its own process in the control table type WIO LOCO s pseudo WTO User defined and built in LOCO command statements are placed in a COMMAND queue waiting area in LOCOMAIN wh commands in ascending time of day sequence waiting for the proper time of day que to occur ue waiting for LOCOMAT sta temen from event processors Time Startup i initiated placed on their respectiv stat N Af S to complete tatements are pl E sta Each STARTUP stat operands are validated MVS commands being processed by SVC 34 are processed internal the table statement is matching WTO cemen on the T If a WA y ME queue The ACTI queues I statement is placed on the TIME queue wait expire When al l the ACTI le waiting for matching laced on a TIME queue ements are placed on a unique STARTUP initialization
50. MVS xxxx defaults to LCON Insure that xxxx is the proper subsystem name for this LOCO Insure that xxxx is defined in IEFSSN in the current SYS1 PARMLIB and that the system has been IPLed since xxxx was defined in IEFSSN XXxx ALREADY INITIALIZED The PARM SSN xxxx specified a subsystem name which has already been initialized by either LOCOINIT If you wish to re initialize an LCON subsystem then you must first un initialize it with program LOCOINIT using PARM SSN xxxx REVERSE GETMAT N FOR LOCOCVT FAI LOCOINIT was unable to storage LOCOMAIN will Contact NETEC Technical convenience LED obtain X 13CC bytes of CSA not be able to run Support at your earliest Xxxx NOT YET INITIALIZED LCON Subsystem xxxx has not been initialized therefore cannot be un initialized with PARM REVERSE It is possible that LOCO I failed for subsystem XXXX at the previous IPL nsure that xxxx is the subsystem name which you wish to un initialize and N Proprietary Product of NETEC International Inc Page 193 Logical Console Operator User Manual 11 12 05 LCONO805 Xxxx FREEMAIN FOR LOCOCVT FAILED Explanation LOCOINIT was unable to freemain the LOCOCVT for subsystem name xxxx User Response Contact NETEC Technical Support at your earliest convenience
51. MVS JCL requirements for jobnames It is a filter keyword the ENDOFSTEP actions will be performed only for terminating MVS tasks with matching jobnames JOBNAME value may contain WILDCARD characters STEPNAME The value must follow the MVS JCL requirements for stepnames It is a filter keyword the ENDOFSTEP actions will be performed only for terminating MVS tasks with matching stepnames STEPNAME value may contain WILDCARD characters JOBTYPE The jobtype must be one of the following strings STC JOB TSU It is a filter keyword ENDOFSTEP actions will only be performed for terminating jobs of matching type CPUID The cpuid is a four digit value representing the internal MVS id of the cpu It is a filter keyword ENDOFSTEP actions will only be performed when LOCO is invoked on that particular cpu The CPUID value may contain wildcard characters The filter condition may Proprietary Product of NETEC International Inc Copyright 2004 Page 83 Logical Console Operator User Manual 11 12 05 TSOID DATE LODATE HIDATE WEEKDAY be reversed by preceding the cpu id value by the symbol E G CPUID CPUA The tsoid is a 7 digit value representing the TSO user id of the submitter of the job which terminated It is a filter keyword ENDOFSTEP actions will only be performed for termin
52. PAGE Name Prompt Size Created Changed ID CAFCTABL 89 2002 03 26 2002 08 31 15 39 09 U2TEC8 DINOIPL 35 2001 09 01 2001 09 08 08 32 30 U2TEC8 DINOTSTI NEWTABLE 208 2001 09 08 2002 10 19 11 53 57 U2TEC8 L TESTTABL _ 208 2001 09 08 2002 10 19 11 54 33 U2TEC8 TTABLE xxEnd 4 00 1 08 13 Connected to host 10 1 1 20 icar 1 22 PM Astart desg amp jcoprs1oo MANUAL ELoco3300 doc M xosoft jl xLoco3300 DEAR BE 1 22PM Proprietary Product of NETEC International Inc Copyright 2004 Page 119 Logical Console Operator User Manual 11 12 05 Successful reloading of the LOCO table will be indicated in the LOCO Table member list as illustrated below d CDDF5100_MANUAL EXTRA Personal Client E l x LOCO TABLE DSNAME NETEC LOCO33 TABLES Row 00001 of 00006 Command gt _ Scroll gt PAGE Name Prompt Size Created Changed ID CAFCTABL 89 2002 03 26 2002 08 31 15 39 09 U2TEC8 DINOIPL 35 2001 09 01 2001 09 08 08 32 30 U2TEC8 DINOTSTI NEWTABLE 208 2001 09 08 2002 10 19 11 53 57 U2TEC8 TESTTABL xLOADED 208 2001 09 08 2002 10 19 11 54 33 U2TEC8 TABLE x Endxs B 100 7 02 15 Connected to host 10 1 1 20 cap 1 22 PM Pstart li deng ScovFs100_Manuat M Loco3300 doc Microsoft a SJLoco3300 fin Snaalt 32 DRAJ a 1 22PM Proprietary Product of NETEC International Inc Copyright 2004 Page 120 Logical Console Operator User Manual 11 12 05 Manipulating
53. QUES Section text SET SR nn required JOBNAME value optional SET Set is an ACTION keyword used to save the WTOR reply number in a reply Svar There are 16 reply Svars labeled R 1 e SR 16 JOBNAME The value must follow the MVS JCL requirements for jobnames It is a filter keyword the PRIME action will be performed only for MVS jobs with matching jobnames which issue the WTOR text JOBNAME value may contain WILDCARD characters Proprietary Product of NETEC International Inc Copyright 2004 Page 82 Logical Console Operator User Manual 11 12 05 EVENT endofstep Statement The endofstep event is triggered when an MVS task terminates which has a matching jobname and stepname DOFSTEP JOBNAME value required STEPNAME value required ACTION text required JOBTYPE value optional CPUID cccc option TSOID ttttttt option DATE date option LODATE date option HIDATE date option WEEKDAY mtwtfss option WAITIME time option WAITEXT text option RESET time option SET SUV nn text option ACTION The text is one of two types of commands 1 an MVS command 2 a LOCO built in command The ACTION keyword may be repeated on the statement At least one ACTION must be coded The ACTION may contain global vars for real time substitution JOBNAME The value must follow the
54. RED ER OUTDD OR OUTDSN her LOCO EXPORT utility control ords is required ect the error and submit the job ution S REQU card OUTD The EXPO the job Corr exec NG FROM THE JCL the OUTDD key D MISS user has specified RT control card and OUTDD keyword is not ect the error and submit the job ution ERITH ER TABLEDD OR TABLEDSN IS REQU RE Neit on t card Corr exec her import export utility has found both the D and OUTDSN keywords on an EXPORT control These keywords are mutual ly exclusive for the OUTDD or OUTDSN keyword was found on One of the for word on an the DDNAME specified in found in the JCL for the for D the TABLEDD or TABLEDSN keyword was found he LOCO import export utility EXPORT control One of the keywords ect the error and submit ution the job Proprietary Product of NETEC International Inc is required for Page 199 Logical Console Operator User Manual 11 12 05 LCONO 928E Explanation User Response LCONO 92 9E Explanation User Response LCON0 930E Explanation User Response LCON0931E Explanation User Response LCON0932E Explanation User Response LCON0 933E Explanation User Response Copyright 2004 TABLEDD AND TABLEDSN ARE MUTUALLY EXCLUSIVE
55. SHR DCB BUFNO 1 CRITCAL2 DD DSN your loco critical file2 DISP SHR DCB BUFNO 1 CRITCAL3 DD DSN your loco critical file3 DISP SHR DCB BUFNO 1 Jh INTRDR DD SYSOUT A INTRDR DCB BLKSIZE 80 SXSPRINT DD SYSOUT SIMULATE DD SYSOUT REPOR DD SYSOUT SYSABEND DD SYSOUT ALOGSUBT DD SYSOUT CAFCSUBT DD SYSOUT DBCTSUBT DD SYSOUT LOCOALOG DD SYSOUT Proprietary Product of NETEC International Inc Copyright 2004 Page 41 Logical Console Operator User Manual 11 12 05 The following JCL will execute LOCO in simulate mode LOCOMAIN JOBS Bisdiccast tear sed athe ats LOCO EXEC PGM LOCOMAIN DPRTY 15 15 PERFORM 9 TIME 1440 REGION 1024K PARM MEMBER tabname SSN xxxx SIMULATE STEPLIB DD DSN your loco loadlib DISP SHR DD DSN your CAFC loadlib DISP SHR Optional DD DSN your DBCT loadlib DISP SHR optional TABLE DD DSN your loco table library DISP SHR SUBMIT DD DSN your loco job stream library DISP SHR CRITICAL DD DSN your loco critical file DISP SHR DCB BUFNO 1 CRITCAL DD DSN your loco critical filel DISP SHR DCB BUFNO 1 CRITCAL2 DD DSN your loco
56. SORTWKO3 DD DSN amp SORTWK3 UNIT SYSDA SPACE CYL 1 1 SYSIN DD DSN your copy of syslog DISP SHR UNIT sysda tape VOL SER vvvvvv DCB RECFM FB LRECL rrr BLKSIZE bbbb Notes 1 Make a copy of your SYSLOG data and provide the appropriate JCL for SYSIN for LOCOLOG to read the SYSLOG data 2 The PARM is a three digit number specifying the position relative to zero of the or which precedes the WTOR text in the syslog records The default is 24 For example 1 2 3 4 5 Dos eu a Iie hed Bie seed vile ID este Oty Be lhe 2 e esi eU 0000 22 01 01 01 IFBO10D ENTER IPL REASON This is position 24 Proprietary Product of NETEC International Inc Copyright 2004 Page 36 Logical Console Operator User Manual 11 12 05 Initializing the LOCO Subsystem LOCO is initialized at IPL time by the standard MVS subsystem mechanism controlled by the IEFSSNxx member of PARMLIB The program module LOCOINIT is the LOCO initialization program that is invoked for each LOCO subsystem defined in IEFSSNxx Proprietary Product of NETEC International Inc Copyright 2004 Page 37 Logical Console Operator User Manual 11 12 05 Specifying the Operational Characteristics of LOCOMAIN The operational characteristics of the execution of LOCOMAIN are controlled through the use of keywords and values specified in the PARM field on the LOCOMAIN execute statement The fo
57. SYSDA SPACE CYL 1 1 SYSIN DD COPY T SYSUT1 O SYSUT2 IIR Proprietary Product of NETEC International Inc Copyright 2004 Page 17 Logical Console Operator User Manual 11 12 05 Step 2 Considerations for the upgrade installation of LOCO If this is a new installation of LOCO this step should be bypassed If you are upgrading from a previous version of LOCO there are several items that should be considered during the installation process The following is a brief list of these items e All LOCO tables must be rebuilt using the LOCOBLDR utility because the compile LOCO table format has changed in this release of LOCO e The LOCO SVC does not have to be refreshed if it is lation already install from a previous LOCO instal N e Care should be taken when placing the LOCO into the system link list The versions of LOCOINIT are not backward compatible Once the copy of LOCOINIT I program has been placed in the system link list and either an IPL or link list refresh has been accomplished older versions of LOCO will not initialize The following technique is recommended for testing new releases of LOCO when previous versions are active in the system o Execute LOCOINIT as a batch job to initialize one of the LOCO subsystem names to be used by this release of LOCO o Execute LOCOMAIN as a batch job to tes functionality
58. SYSPRINT DD SYSOUT SYSUDUMP DD SYSOUT SYSLIST DD SYSOUT SYSIN DD M IMPORT EXPORT CONTROL CARDS HERE Proprietary Product of NETEC International Inc Copyright 2004 Page 47 Logical Console Operator User Manual 11 12 05 IMPORT Command The IMPORT command is utilized to move LOCO table source from a sequential or partitioned data set into the LOCO table library Optionally the table source may be listed to the SYSLIST ddname and may be processed through the LOCOBLI placed in the LOCO table library by LOCOBLDR it will be pl may be edited via the LOCO table main TSO ISPF but it cannot be loaded my LOCOMA been succe COMMANI NDSN TABLEDD TABLEDSN IST Copyright 2004 dddddddd is the used as inpu be jither b TABLE L INI IN DD dddddddd L D ssfully processed by LOCOBLDR IMPORT command follows OPERANI INDSN a b c d TABLED YES NO D tttttttt DSN e f g h IST YES NO BUI DR process befor If the source is not processed laced into the LOCO table library and tenance process under IN until The format of the MEMBER mmmmmmmm nnnnnnnn REPLACE DD n NAME tial Gutt i IND keyword a b inp u a sequential keyword is m a seq D keyword is C d is the for the import pr O
59. Text Messages You may place multiple strings of wildcard characters in WTO WTOR and COMMAND text When LOCO matches the wildcard characters in the actual console message against the LOCO table entries LOCO ignores accepts any text in the wildcard positions Example ABC HIJ LOCO will look for a match on ABC in the first three positions and a match on HIJ for the 8th through 10th positions through 7 It will ignore accept any text in positions 4 Variable symbol usage There is a in the ACT lso a set of variable symbols which may be keyed ON operand value These variable symbols will be replaced with their real time values at the time of execution of the ACTION The variable symbols are SVariable STIME DATE DATE2 DATE3 DATE4 DATES DATE6 SWEEKDAY SCPUID Xr X o doudou Copyright 2004 Format Max Length Type hh mm ss 8 global mm dd yy 8 global yyddd 3 global yymmdd 6 global mm dd yyyy 10 global yyyydad 7 global yyyymmdd 10 global XXXXXXXXX 9 global EGEE 4 global Proprietary Product of NETEC International Inc Page 52 Logical Console Operator User Manual 11 12 05 SUV L SuV 32 SR 1 SR 16 STEXT SMINOR SJOBNAME SSTEPNAME SJOBID STSOID SORIGIN SEXITEXT XKX e 120 global XXX 120 globa
60. The WAITEXT delays the reply until VTAM initialization is complete Time Filters LOTIME and HITIME operands may be coded singly or in pairs on LOCO statements f LOTIME is coded and HITIME is not then HITIME is considered to be the following midnight f HITIME is coded and LOTIME is not then LOTIME is considered to be the preceding midnight If both are coded and the LOTIME value precedes the HITIME value then a segment of the day is selected to consider triggering the associated event If both are coded and HITIME precedes LOTIME then two disjoint segments of the day are selected to consider triggering the associated event An example of the last case is WTO ABC123 ACTION S TASK047 LOTIME 20 00 00 HITIME 04 00 00 Here the desired time range is 8 PM until 4 AM each night So in any given 24 hour day midnight to midnight there is an early morning period of midnight until 4 AM and a late night period of 8 PM until midnight A WTO of ABC123 occurring during either of these two periods will trigger the ACTION Proprietary Product of NETEC International Inc Copyright 2004 Page 154 Logical Console Operator User Manual Date Filters LODATE and HI 11 12 05 DATE operands may be coded singly or in pairs on
61. The following example JCL will copy the LOCOINIT program into the link list library SYS1 LINKLIB LOCOINST JOBS yd natasha dd dua a tee ari Aa and LOCOCOPY EXEC PGM IEBCOPY SYSPRINT DD SYSOUT INPUT DD DSN your load pds DISP SHR OUTPUT DD DSN SYS1 LINKLIB DISP SHR SYSIN DD COPY I INPUT O OUTPUT SELECT M LOCOINIT SELECT M LOCOSSSM Proprietary Product of NETEC International Inc Copyright 2004 Page 23 Logical Console Operator User Manual 11 12 05 Step 5 Define LOCO as a subsystem to your MVS system You may pick any valid sub system name that meets your installations naming conventions The subsystems must be defined in the IEFSSNxx member of SYS1 PARMLIB using the selected subsystem name LOCOINIT as the initialization program and the LOCO SVC number as the parm If you do not use the LOCO SVC then the parm is not required See the app manual Initialization and defining subsystems in the ropriate MVS level of the IBM Tuning Guide for details on IEFSSNxx member The following is an example of an IEFSSNxx member LOCO definition ACF INITRTN IRRSSIOO INITPARM before the addition of the SUBSYS SUBNAME SMS INITR
62. The location determined by PARM If da utilized If below the line CSA be OL M I parameter on ta space created by LOCOMA DS NO is specified th blocks that DS xxx parameter Specified tive de active e LOCO system maintains only key control items such as its ac information ting found on IN at S In both cases the DEFINE command housed in CSA LOCOMAIN will the possible usage of CSA by WTO b available CSA at LOCO table load time adjust the QL locks exceeds 50 percent of the The static amount of CSA indicators logic are held in are wal counters this storage to be processed is the LOCOMAIN execute the WTO blocks are stored in a tartup time and no CSA is WTO blocks are stored in the maximum number of WTOs to held for processing is specified in the LOCO table via the If the WTO blocks are M I value downward if used by LOCO 3 3 is less than 4K bytes below the line and approximately 12K bytes above the line DS NO is specified only used when LOCO activities are specific WTO R text or time of day or LOCO built in commands constrained by filters such modified symbol values and by direct text action text may be triggering WTO R controlled by a specifying certain actions to be exec text WTP text in real
63. The queue is available to be triggered for action Paused The queue is unavailable to be triggered for action Held Queue is currently held Proprietary Product of NETEC International Inc Copyright 2004 Page 123 Logical Console Operator User Manual 11 12 05 Released Queue is currently released WTO is currently gt Activ The queue is available to be triggered for action Paused The queue is unavailable to be triggered for action WTOR is currently gt Activ The queue is available to be triggered for action Paused The queue is unavailable to be triggered for action EVENT is currently gt Activ The queue is available to be triggered for action Paused The queue is unavailable Security Requirments to be triggered for action READ access to the To manipulate these resources requires following SAF Profiles LOCO xxxx SSI LOCO xxxx RESOURCES BROWSE LOCO xxxx RESOURCES HOLD LOCO XXXX RESOURCES xxxx The one to ACTIVATE four charact to TO to to resources access the LOCO subsystem display resources hold release resources activate deactivate ter LOCO subsytem name Proprietary Product of NETEC International Inc Copyright 2004 Page 124 Logical Console Operator User Manual 11 12 05 Submitting Batch Jobs Through LOCO The following screen is displayed when option 5 is entered from th
64. U 17 00 ACTION P FRANK WAITEXT AHLOO6I ACTION gt PRINTJOB In the event that the LOCO task itself starts execution between 16 00 and 17 00 the 17 00 event would be triggered The P FRANK would have no effect since FRANK never got started the WAITEXT for AHLOO6I would hang in a never ending wait since AHLOO6I is produced by FRANK s termination which did not occur and the Proprietary Product of NETEC International Inc Copyright 2004 Page 153 Logical Console Operator User Manual 11 12 05 17 00 LOCO table statement would not be active for time triggering the next day as the clock passes through 16 00 and then through 17 00 A better set of LOCO statements would be 16 00 ACTION S GTF FRANK WAITIME 01 00 00 ACTION P FRANK WAITEXT AHLOOOI ACTION Q 5PRINTJOB WTOR AHL125A REPLY END Here all the events controlling FRANK are contained in a single statement so that it is not possible for a segregated subset of ACTIONs to be triggered independently of the others Delayed reply to WTOR It is possible to delay the REPLY to a WTOR in an LOCO table tatement by inserting a WAITEXT before the REPLY n WTOR IKTOO3D TCAS UNABLE WAITEXT ISTO20I VTAM INITIALIZATION COMPLETE REPLY RETRY Here TSO is trying to come up before VTAM is initialized
65. a time attach one of the internal subt program had never reshed out while trying to asks Contact NETEC Technical support Proprietary Product of NETEC International nc Page 177 Logical Console Operator User Manual 11 12 05 LCONO160 Explanation User Response LCON0161 Explanation User Response LCON0162 Explanation User Response LCON0163 Explanation User Response LCON0164 Explanation User Response LCON0165 Explanation User Response Copyright 2004 AUTHOR LOCOMA This ZAT Check the installa mechanism and correct any errors is probably d LOCMAIN process ON MECHAN N cannot get ue to an installation error tion of the authorization SM HAS FAI LE authorized Restart the CAFC SUPPORT IS CURRENTLY DISABLED ACTION BYPASSED LOCOMAIN has attempted to execute a CAFC command and the CAFC support in LOCOMAIN is currently disabled The action has been ignored Either remove the CAFC action from the LOCO table or enable the CAFC support in LOCOMAIN by placing CAFC YES in DB CONTROL S BYPASSED LOCOMAI command and the LOCOMA N parm UPPORT IS e N has a the currently disabled Either remov th tabl by placing nable th DBCT YE or S ttempted UR
66. and Search Facility System ID NTCI 9 LM Facility Library administrator functions MVS acct NONEXX 1 IBM Products IBM program development products Release ISPF 5 0 11 SCLM SW Configuration Library Manager 12 Workplace ISPF Object Action Workplace I IMS OPER IMS TSO Operator Interface L Loco Logical Console Operator Interface N Network Print Network Print Facility M More Additional IBM Products Enter X to Terminate using log list defaults 1C 01 7 04 14 mem Connected to host 10 1 1 20 12 14 PM Proprietary Product of NETEC International Inc Copyright 2004 Page 106 Logical Console Operator User Manual 11 12 05 After pressing the ENTER key the following LOCO TSO interface screen will be displayed 2 CDDF5100_MANUAL EXTRA Personal I Client E l x File Edit View Tools Session Options Help Mister mE EE Logical Console Operator TSO Operator Interface Main Selection Menu Command gt _ Set Operation Parameters USERID U2TEC8 l Display Loco Status TERMINAL 3278 2 Perform Loco Table Maintenance TIME 10 35 3 Manipulate Loco Trace DATE 02 10 19 4 Activate Deactivate Hold Release Resources LOCO Name LOCA 5 Submit Batch Jobs Through Loco 6 Display Manipulate Loco Queues A licensed proprietary product of NETEC International Copyright 2002 B 6 00 1 04 15 Proprietary Product of NETEC International Inc Copyright 2004 Page 107 Logical Console Operator
67. any LOCO TSO interface connecting to any LOCO subsystem LOCO LOCA RESOURCES HOLD Specific profile that will match users who are trying to access resources on the LOCO subsystem named LOCA Users permitted with READ access to this profile will be able to hold and release resources on the LOCO TSO interface connecting to LOCO subsystem LOCA The RACF commands necessary to define these profiles are Proprietary Product of NETEC International Inc Copyright 2004 Page 146 Logical Console Operator User Manual 11 12 05 RDEFINE FACILITY LOCO RESOURCES BROWSE UACC NONE RDEFINE FACILITy LOCO LOCA RESOURCES HOLD UACC NONE Permission to submit jobs through LOCO LOCO ssss SUBMIT XXXXXX ssss Subsystem Name BROWSE User can browse the jobs available for submission EDIT User can edit jobs in the LOCO submit library SUBMIT User can request LOCO submit jobs from the LOCO submit library Example LOCO SUBMIT BROWSE Generic profile that will match any request to access any LOCO subsystem Users permitted with READ access to this profile will be able to browse jobs in the LOCO submit library of any LOCO TSO interface connecting to any LOCO subsystem LOCO LOCA SUBMIT SUBMIT Specific profile that will match users who are trying to access the LOCO subsystem named LOCA Users permitted with READ access to
68. can be displ layed by issuing the G STATUS command The following proc can be used to start LOCOMAIN from the MVS console LOCOX IEFPROC STEPLI TABLE SUBMIT CRITICAL CRITCALl CRITCAL2 CRITCAL3 INTRDR SYSPRINT SYSABEND B Copyright 2004 PROC M DUMMY EXEC PGM LOCOMAIN DPRTY 15 15 PEFFORM 9 PARM MEMBER amp M SSN amp S DD DSN your loco loadlib DISP SHR DD DSN your loco table library DISP SHR DD DSN your loco job stream library DISP SHR DD DSN your loco critical file DISP SHR DCB BUFNO 1 DD DSN your loco critical filel DISP SHR DCB BUFNO 1 DD DSN your loco critical file2 DISP SHR DCB BUFNO 1 DD DSN your loco critical file3 DISP SHR DCB BUFNO 1 DD SYSOUT A INTRDR DCB BLKSIZE 80 DD SYSOUT DD SYSOUT Proprietary Product of NETEC International Inc Page 44 Logical Console Operator User Manual 11 12 05 Example START command S LOCOX M tabname S LCOJ Proprietary Product of NETEC International Inc Copyright 2004 Page 45 Logical Console Operator User Manual 11 12 05 Utility Guide Creating and Maintaining LOCO Tables Creating LOCO Tables with LOCOBLDR The LOCOBLDR job compiles source control tables in batch into object tables to be used by
69. contain The cpuid is a four digit value representing MVS id of the cpu Qtime actions will only be performed when LOCO is invoked on that particular cpu contain wildcard characters be reversed by preceding the cpu id value by nbol che ter keyword D value may The filter condition may the of MM DD YY or actions wil date of MM actions will ular date of MM actions will DD YY or DD YY or on or before that particular date HIDATE and LODATE may be specified together DATE may not be specified with either of them If any of the above date operands is specified as MM DD YY LOCO will provide the complete YYYY internally Proprietary Product of NETEC International Inc If YY is in the range of 00 through Page 77 Logical Console Operator User Manual 11 12 05 WEEKDAY The str the wee 50 then the century will be set to 20 if YY is higher than 50 then the century will be set to 19 ing of characters represents the seven days of k beginning with Monday It is a filter keyword The actions will NOT be performed on weekday positio WEEKDAY ns which contain a period Example M F would cause the actions to be performed on Monday and Friday only Note REPEAT UNTIL amount cause t interva Whenever multiple filter keywords are coded all criteria must be satisfied in order for the act
70. cpuid is a four digit value representing the internal MVS id of the cpu It is a filter keyword WTO actions will only be performed when LOCO is invoked on that particular cpu The CPUID value may contain wildcard characters The filter condition may be reversed by preceding the cpu id value by the minus symbol E G CPUID CPUA The tsoid is a 7 digit value representing the TSO user id of the submitter of the job which produced the WTO triggering event It is a filter keyword WTO actions will only be performed for WTOs from jobs submitted by that TSO user The TSOID value may contain wildcard characters The filter condition may be reversed by preceding the TSO id value by the symbol E G TSOID PC1 The origin is an 8 byte value representing the JES sysid from CTXTSYSN field of the CTXT WTO actions will only be performed for WTOs from matching origins This filter is particularly useful for JES3 environments Note Whenever multiple filter keywords are coded all criteria must be satisfied in order for the actions to be performed The filter keywords are functionally connected by a logical AND operator The count represents the number of times the WTO must be encountered before the ACTION is performed THRESHOLD is reset each time the ACTION is performed The time is of the format HH MM SS and represents an amount of time not a clock value This key
71. defaults to zero WAIT WA RESET SET Copyright 2004 ME ITEXT Ihe time is of the amount of time not A WAII a clock value table the If SLEEP is not explicitly format HH MM SS and represents an ME may be coded after an ACTION causing a wait for that amount of the next ACTION characters including time before proceeding to The text is any string of WILDCARD causing a wait until that WTO through the MVS system a WTO the next ACTION is performed text string is issued Note ACTIONS A WAITEXT may be coded after an ACTI the ON as a After the text is seen as Both WAITIME and WAITEXT may be coded between In that case the second ACTION will be performed as soon as EITHER wait condition is satisfied The wait keywords are functionally connected by a logical OR operator The time is of the format HH MM SS and represents an amount of time not a clock value A RESET may coded only after a WAITEXT and specifies an amo time after which LOCO is WA executing any of the following ACTIONs entry will then wait for the next occurrence of original WTO text insert values be unt of to automatically terminate the ITEXT and recycle the LOCO table entry without The table the into SET is an ACTION keyword used to user SVARS There are 32 user Sv
72. example Ihe double dots The changes have indicate missing lines of informa shorten the listing tion that have been removed to PANEL KEYLIST ISRSAB ISR IMAGE amp ZIMGNAM amp ZIMGROW amp ZIMGCOL ATTR DEFAULT FORMAT MIX ISR PRIM ENGLISH 5 0 OB TYPE AB OD TYPE PS 04 TYPE ABSL GE ON AREA SAREA39 0 Settings Terminal and user parameters 1 View Display source data or listings 2 Edit Create or change source data 3 Utilities Perform utility functions 4 Foreground Interactive language processing 5 Batch Submit job for language processing 6 Command Enter TSO or Workstation commands 7 Dialog Test Perform dialog testing 8 LM Facility Library administrator functions 9 IBM Products IBM program development products 10 SCLM SW Configuration Library Manager 11 Workplace ISPF Object Action Workplace INIT PROC IF amp ZCSTF 1 ATTR GRPBOX1 WIDTH 0 IF CURSOR TMPROWS AND amp ZCMD amp ZSAR TRANS amp ZSCREEN 1 amp ZSAREA1 2 amp ZSAREA2 3 amp ZSAREA3 4 amp ZSAREA4 IF amp ZSAR CAL UPS SES amp ZCMD SP amp ZSEL TRANS TRUNC amp ZCMD 0 PGM ISPISM SCRNAME SETTINGS 1 PGM ISRBRO PARM ISRBROO1 SCRNAME VIEW 2 PGM ISREDIT PARM P ISREDMO1 SCRNAME EDIT 3 PANEL ISRUTIL SCRNAME UTI
73. exit is in control due to an unexpected condition LOCOMAIN has completed a controlled shutdown None Proprietary Product of NETEC International Inc Page 183 Logical Console Operator User Manual 11 12 05 Messages from LOCOINTF Messages ar shown with LCON as th LCON0601 LCON0699 m ssage prefix This prefix will be changed to the current subsystem name by LOCOINTF at execution time then th If LOCOINTF be LCOBB500 mess Explanation ages will PARM VALUE TOO LARGE Parm value is too large than 79 bytes User Respons Remov xtraneous data from PARM LCONO601 PARM MSG NOT BEGIN WITH QUOTE Explanation Parm MSG did not have a quote after th User Response LCON0602 Explanation User Response LCON0603 Explanation User Response LCONO0604 Explanation User Response LCONO605 Explanation User Response LCONO 606 Explanation User Response Copyright 2004 Provide th Example MSG PARM TOO LONG The LOCOCVT NOT SET UP Th sure that LOCOIN is subsystem name In th SU Ih BSYSTEM NOT FOUND MAX SI etc is run on behalf of subsystem LCOB LCOB501 BE It may not 79 BYTES be longer sign required quotes around the MSG text PARM SSN xxxx MSG 2 message text of the MSG PARM was longer than 80 bytes
74. host 10 1 1 20 11 23 AM From this screen the user can delete hold or release a specific entry on the LOCO SHUTDOWN queue Each queue entry is formatted on multiple lines Before the beginning of a queue entry is an action field where the user specifies what action he would like LOCO to take against the following SHUTDOWN queue entry The valid actions that can be specified for a queue entry are Action Description H Hold the SHUTDOWN queue entry Prevent LOCO from taking action should actions required to execute this queue entry be meet Proprietary Product of NETEC International Inc Copyright 2004 Page 138 Logical Console Operator User Manual 11 12 05 Release the SHUTDOWN queue entry Release LOCO to take action should actions required to execute this queue entry be meet Delete this SHUTDOWN queue entry LOCO will remove the entry from the SHUTDOWN queue To replace th ntry in the queue will require the LOCO table be reloaded Security Requirements To manipulate these resources requires READ access to the following SAF Profiles LOCO LOCO LOCO LOCO XXXX Copyright 2004 XXXX SSI XXXX QUEUES XXXX QUEUES XXXX QUEUES The one to access the LOCO subsystem SHUTDOWN BROWSE to display queue entries SHUTDOWN HOLD to HOLD RELEASE queue entries SHUTDOWN DELETE to DELETE queue entries
75. indicating the LOCO DB Control subtask has stopped internal tracing Issued by LOCODBCT User Response none LCON0724 DB CONTROL INTERFACE SUBTASK BEGINNING TERMINATION Explanation This is an information message indicating the LOCO DB Control subtask is beginning termination Issued by LOCODBCT User Response none LCON0726 DB CONTROL INTERFACE SUBTASK INITIALIZATION COMPLETE Explanation This is an information message indicating the LOCO DB Control subtask has completed initialization Issued by LOCODBCT User Response none LCON0727 DB CONTROL INTERFACE SUBTASK TERMINATION COMPLETE Explanation This is an information message indicating the LOCO DB Control subtask has completed termination Issued by LOCODBCT User Response none LCON0729 DB CONTROL COMMAND ABORTED Explanation This is an information message indicating the previous DB control command has been aborted Issued by LOCODBCT User Respons Determine the original error and correct Proprietary Product of NETEC International Inc Copyright 2004 Page 188 Logical Console Operator User Manual 11 12 05 LCON0730 Explanation Issued by User Response LCONO731 Explanation Issued by User Response LCON0732 Explanation Issued by User Response LCON0733 Explanation Issued by User Response LCON0734 Explanation Issued by User Response LCON0735 Explanation
76. it is a generic name If the member name is specified as a single asterisk e library will ta se be ential file and REPLACE is specified and FORMAT IEBUPDT wi specified REPL cards exported source instead of Al 1l be D E is placed in D control c the output is a PDS and REPLACE is not spec in the output da identical names will not be replaced If n members that already exi specified and mmmmmmmm i mmmmmmmm will be renamed output table library SU the ards LE ified Proprietary Product of NETEC International Inc ta set with nnnnnnn is s not a generic name member to member nnnnnnnn in the Page 51 Logical Console Operator User Manual 11 12 05 Control Table Syntax The general values enclosed series follow the last values can be card syntax is keywords followed by their associated within parentheses KEYWORD value If the of keywords continues beyond one card then a must keyword on each card except the last Operand which are strings of text too long to fit on a single card CARDSIZE No continuation WILDCARD usage continued by coding text through the last column of the and continuing in column one of the next card symbol is used in this case This facility supports positional wildcard characters in text messages
77. length of output data max 120 bytes D2 DS CL120 output data If the following ACTION is encountered in an LOCO control table ACTION USERPROG ABCDEF then USERPROG will be loaded into the LOCOMAIN address space and retained ther L1 will be set to H 6 D1 will be set to C ABCDEF with trailing blanks L2 will be set to H O D2 will that word wil be set to blanks R1 will be set to a one word parm list and l contain the address of L1 The address of be loaded into R15 and a BALR R14 R15 will be USERPROG will issued When control is returned to LOCOMAIN if D2 is none zero then to subsequent the data in D2 is set into the Variable SEXITEXT and is available ACTIONs USERPROG must be linked as APF authorized and loaded from an APF authorized library so that LOCOMAIN will retain its a The following u thorization sample LOCO user exit programs are included in the LOCO distribu LOCOEXI tion source library T ALC exit program Copyright 2004 Proprietary Product of NETEC International Inc Page 96 Logical Console Operator User Manual 11 12 05 Operations Guide Operational Commands LOCO has a variety of built in commands to control its activities A special character that is defined by the user on the DEFINE PREFIX statement prefixe
78. list contains all members currently available for 02 15 nri i 11 52 AM the LOCO submit ugh LOCO The user can enter three actions in the field preceding the member name The user can 1 Request LOCO submit the job for batch execution 2 Browse the member 3 Modify the member contents through ISFP edit The user indicates the required action by placing a S in the action field for a request to LOCO to submit the job a B in Proprietary Product of NETEC International Inc Copyright 2004 Page 125 Logical Console Operator User Manual 11 12 05 the action field to brows field to edit th member of an E in the action the member Standard ISPF statistics are maintained for the LOCO Submit library Security Requirments To manipulate following SAF LOCO Xxxxx LOCO xxxx LOCO xxxx XXXX Copyright 2004 these resources requires READ access to the Profiles SSI SUBMIT BROWSE LOCO Xxxxx SUBMIT EDIT SUBMIT SUBMIT The one to four to display the queu to access the LOCO subsystem tries to request LOCO submi n to edit the submit data set the job character LOCO subsytem name Proprietary Product of NETEC International Inc Page 126 Logical Console Operator User Manual 11 12 05 Successful submission of the LOCO batch job will be indi
79. manipulate these resources following SAF Profiles LOCO Xxxxx SSI requires READ ac LOCO xxxx QUEUES STARTUP LOCO xxxx QUEUES STARTUP LOCO xxxx QUEUES STARTUP XXXX The one to four to acc subsys BROWSE to dis HOLD to HOL entrie DELETE to DEL character LOCO s place th ntry in be reloaded cess to the ess the LOCO tem play queue entries D RELEASE queue S ETE queue entries ubsytem name Proprietary Product of NETEC International Inc Copyright 2004 Page 137 Logical Console Operator User Manual 11 12 05 Displaying and Manipulating the SHUTDOWN Queue The following screen is displayed when the user selects the SHUTDOWN queue for manipulation 3 CDDF5100_MANUAL EXTRA Personal I Client File Edit View Tools Session Options Help where Logical Console Operator TSO Operator Interface Display Manipulate Shutdown Queue for LOCA Command gt _ Scrol gt CSR SHUTDOWN UNTIL 24 80 00 HITIME 24 00 00 LODATE 2002 001 HIDATE 2002 365 WEEKDAY MTWTFSS CPUID NTC1 ACTION SHUT ACTION3 SET SUVI2 VARTABLE2 _ SHUTDOWN UNTIL 24 00 00 HITIME 24 00 00 LODATE 2002 001 HIDATE 2002 365 WEEKDAY MTWTFSS CPUID NTCI ACTION SHUT ACTIONI ACTIONCSHUT ACTION2 SET UV 2 VARIABLEZ HRRKRRKRRRRRKRRRRRKRRRRRKHRRR END OF QUEUE XXXXWXXWEHMXKXKRENRNXXKKRXRMXXXKXM 00 1 03 15 mu Connected to
80. missing Supply missing D D card EXPECTED STATEMENT KEYWORD XXXXXXXXXXXX is not DD card for ddname XXXXXXXx FOUND XXXXXXXXXXXX a valid LCON statement keyword Valid statement keywords are WTO WTOR COMMAND DEFINE STARTUP Correct the invalid statement keyword See LCON USER GUIDE for valid keyword usage If you did not intend for a new LCON statement to begin with the sp continua cified keyword XXXXXXXXXXXX YYYYYYYYYYYY hen there may be a missing tion indicator on the previous line 9 NCORRECT STRUCTURE FOUND The value yyyyyyyyyyyy is not in the required Structural format for the keyword XXXXXXXXXXXX time of day Correct the s EXPECTED OPERAND CEU ctural KEYWORD The sta instead of them are tement syntax ch operand keyword but fo WI L DCARD FOUN cker und the text There are many operand keywords xpect If the keyword value contains a clock value or then too many colons error were found D XXXXXXXXXXXX d to find an XXXXXXXXXXXX Some CARDS DATE LODATE H DATE WE EK REPEAT REPLY SLEEP DAY THRESHOLD ZE PREF X JOBNAME LOT ME HITIME ACT LON RESET WAITIME
81. n GCZERO Command wicks Coke eee a eee Se ee e ES ee a Se Ree CP COMMANA NP ieee ie eke ek ee ie Pie EDAD Ce TOI sve m draps por ote wins Ba eee SS Set a Se oe eS so Commande eMe PATS there Pe CSS CSA wh TAS Ql Commandos eae ae mu ee a ECCE aR Command soc n RUE tene xo erede RUE ee eds INES iere fee eos ode ded deleti QGREFERESH Command zug see a eeu Uem LEX bee ele ei edd Se e EY TSO HUSGrs GUZdQg x hears Ss Ae RU ok Wn eas SURE Ou ROSE UA e RUE Be Setting Operational Paramet terg Li 4764 EE E c durus Dasspdayohg qoCcOcStgtus hawt Dae ote EMG EE WWE Security REGUITMENES 6 casi dase eieon dt ewkhiws ote E rm eere s Performing LOCO Table Maintenance 2c eee eee eee eee Browsing a GOCO Tables ihre adiel es Wie siete ek oie eee ele we ecu ete Pe eld Editing a LOCO Tables ereserki re es ew ee ee See eee ee eee eae Toacatig a coco Malle shee eed eee ee a EI Ce a a Manipulating LOCO Tracer sc edie weit st wb uu wid te Bie Se owe Activating Deactivating Holding and Releasing Resources Submitting Batch Jobs Ihrough LOCO 22 2249 Ee ree ec Displaying and Manipulating LOCO Queues Displaying and Manipulating the TIME Queue Security R quirements s o s ewe meg ded xe Re RU RR RU Re es Displaying and Manipulating the WTO Queue SeQurrty Regqurrements tiie aie et aed Ba di ered Sela uui See eu Displaying and Manipulating the WTOR Queue Security REGUI
82. of NETEC International Inc Page 49 Logical Console Operator User Manual 11 12 05 EXPORT Command The EXPORT command is utilized to move LOCO table LOCO table library to a sequential or partitioned Optionally the table source may be listed to the and may have ADD or REPL cards added to the The format of the EXPORT command follows COMMAND OPERAN EXPORT OUTDD dddddddd OUTDSN a b c d TABLEDD tttttttt TABLEDSN e f g h LIST YES NO FORMAT IEBUPDTE SO urce from the data set SY SLIST DDNAME ou tput stream MEMBER mmmmmmmm nnnnnnnn REPLACE OUTDD dddddddd is the DDNAME in the LOCOIMEX JCL that is to be the target of the exported table source The OUTDD can either be a sequential or partitioned data set The OUTDD keyword is mutually exclusive with the OUTDSN keyword OUTDSN a b c d is the DSNAME of the target data set for the exported table source The OUTDSN can be either a sequential or partitioned data set The OUTDSN keyword is mutually exclusive with the O UTDD keyword TABLEDD tttttttt is the DDNAME in the LOCOIMEX JCL that is to be the LOCO table library that contains be exported The TABLEDD must be a PDS LOCO tables The TABLEDD keyword is mut exclusive with t
83. requested table has been compiled by LOCOBLDR to that library N VALID SEGMENT TYPE Th in aft in in In LO wi e structure of the LCON object table is correct The object table may have been damaged er compilation or LOCOBLDR may have created it error The table may have been damaged ternally by LOCOMAIN Sure that the releas COMAIN are the sam th LOCOBLDR if the error persists levels of LOCOBLDR and Recompile the LCON table contact NE TEC Technical Support I ME QUEUE ERROR A wa TO Co AB A du No CO An MO wi DE LC wi Ho wi th x Statement on the TI iting flag was not one of SLEEP TI D ntact NETEC Technical Support ME queue expired but its ME TXTIME or END AT CONSOLE REQUEST DUMP command was received from the console A mp will be produced with USER ABEND code ne MMAND MUST BEGIN WITH x LCON command was presented to LOCOMAIN from a DIFY command The LCON command did not start the LCON command prefix character from the FINE statement ON commands may be keyed directly on the console th no need to use the MVS MODIFY command wever in both cases the LCON command must begin th the LCON prefix character defaults to Proprietary Product of NETEC International Inc Page 170 Logical Console Operator User Ma
84. text from the MINOR data line for substitution into the ACTIONS Either MINOR or MINOR but not both must be specified The text is one of the two types of commands 1 an MVS command 2 a LOCO built in command The ACTION keyword may be repeated on the WTO statement At least one ACTION must be coded The ACTION text may contain global or local vars for real time substitution This operand will cause the WTO to be routed to the hardcopy log only It will not appear on any MVS console DELETE This operand will cause the WTO to completely disappear REROUTE LOTIME Ihis operand will change the routing and descriptor codes of the original WTO The routing codes are keyed as Rn where n ranges from 1 through 128 descriptor codes are keyed similarly as Dn where n ranges from 1 through 16 Multiple routes and descriptors may be keyed in any order separated by commas The actions implied by these codes are described in IBM s manual titled Routing and Descriptor Codes Example REROUTE D3 R7 The time is in the format of HH MM SS and represents a clock value It is a filter keyword WTO actions will only be performed on or after that particular time of day DATE LODATE HIDATE Copyright 2004 Ihe time is in the format of HH MM SS and represent
85. the job for execution t the job for VE the IMPORT control D D key word on an DNAME specified in und in the JCL for the job for uired on the LOCO IMPORT control card the job for the MEMBER keyword of the IMPORT control card Proprietary Product of NETEC International Inc Page 198 Logical Console Operator User Manual 11 12 05 LCON0922E Explanation User Response LCON0923E Explanation User Response LCON0924E Explanation User Response LCON0925E Explanation User Response LCON0926E Explanation User Response LCON0927E Explanation User Response Copyright 2004 THE The spec Corr exec THE The spec INDSN CAN NOT BE FOUND user has specified th INDSN key ified in the ect the error and submit ution the job TABLEDSN CAN NOT BE FOUND user has specified th ified in the TABLEDSN keyword is word on an IMPORT control card and the data set name INDSN keyword is not be found for TABLEDSN key word on an IMPORT control card and the data set name not be found Correct the error and submit the job for exec OUTD The OUTD ution D AND OUTDSN ARE MUTUALLY EXCLUSI VE LOCO stat and Corr exec ement one must be removed ect the error and submit the job ution EITH Neit the keyw Corr exec
86. to issue LOCO ACTIONs in the event of 2 condition the console as a WTO by issuing the MVS command MN The sample LOCO table member was not ca termination to programmer message log NOT CATLGD routed to STATUS Copyright 2004 EF287 is used to indicate that a data set location processing at step ly a WTO but rather a WTP write you ly in the data set disposition EF287 may cause the message to be EF287 shows how to code Proprietary Product of NETEC International Inc Page 155 Logical Console Operator User Manual 11 12 05 LOCO ACTIONs for message IEF287I n the event that you do not want the IEF2871 message to actually appear on your console you need only ask LOCO to suppress it by adding the operand SUPPRESS to the table entry for WTO IEF2871I An alternate method of causing IEF2871 messages to be routed to the console is to ZAP the routing bits in IEFAB4M6 which is a message table residing in SYSI LPALIB DUMP IEFW21SD IEFAB4M6 NAME IEFW21SD IEFAB4M6 VER OOBE 20D5 D6E340C3 C1E3D3C7 C44040E7 VER 00CC 10000020 0 REP 00CC 10004020 SI SI Deferred reply to WTORS It is possible to defer the reply to a WTOR by maintaining the reply number in an LOCO reply Svar Suppose that in an LOCO shutdown procedure y
87. trace of LOCO activities to a SYSOUT dataset This option should only be activated at the request of NETEC technical support This option will produce a high volume of output The option can also be activated through the LOCO TSO interface after LOCOMAIN has begun execution Proprietary Product of NETEC International Inc Copyright 2004 Page 38 Logical Console Operator User Manual 11 12 05 Parameter Values Description TRWOE The presence of PARM field will internal trace to a SYSOUT cause LOCO dat WOES that enter exit specified to obt TRWQE keyword support volume activated at the request of output the TRWQE keyword in the to produce an taset of all the LOCO subsystem SVC 35 The TRACE option must tain any output also be from the This option should only be of NETEC technical This option will produce a high The option can also be activated through the LOCO TSO interface after LOCOMAIN has begun execution TRMSG internal This IN from The TRACE option The presence of the TRMSG keyword in the PARM field will cause LOCO to produce an trace to a SYSOUT dataset of all WTO blocks receive by LOCOMA subsystem SVC 35 exit must also be specified to obtain any output from the TRMSG keyword only be activated at the technical support a high volume o
88. write a message describing a critical situation or condition to the file defined by the CRITICAL DD statement in the LOCOMAIN JCL The CRITICAL file may be reviewed periodically thru TSO or some other software product which can browse a file online The CRITICAL file remains closed between commands COMMAND OPERANDS If the two byte immediately following the character is a 1 2 or 3 then the message is written to CRITCAL1 CRITCAL2 or CRITCAL3 ddname respectively This facility allows different levels of intensity of critical messages to be segregated into different files Command The CALL command is for use as an ACTION in an LOCO control table It may be used to invoke a user written exit program Example ACTION yourprog abcdefgh COMMAND OPERANDS The text operand is passed to the exit program and data may be returned into variable symbol SEXITEXT which may be used in subsequent ACTIONs See the SPECIAL TECHNIQUES chapter for details on EXIT PROGRAMS Proprietary Product of NETEC International Inc Copyright 2004 Page 104 Logical Console Operator User Manual 11 12 05 REFRESH Command The REFRESH command will cause the specified user exit program to be reloaded so that a newly assembled exit program can be implemented without termin
89. 01 09 08 2002 10 19 11 54 33 U2TEC8 TTABLE xxEndxs 00 1 02 15 Connected to host 10 1 1 20 is fef 1 19 PM ll Jc e s a amp icoprsi00 MaNUAL E Loco3300 doc Microsoft CuLocosao0 ORAL 119pm The screen is the member selection screen for the LOCO table library The list contains all LOCO table members currently available for browsing editing or loading to batch through LOCO The user can enter three actions in the field preceeding the member name The user can 1 Request LOCO load the table for processing 2 Broswe the LOCO table member 3 Modify the member contents through ISFP edit Proprietary Product of NETEC International Inc Copyright 2004 Page 113 Logical Console Operator User Manual 11 12 05 After successful modification the LOCOBLDR process will be involked to rebuild the LOCO table and the user will have the ability to replace th xiting LOCO table in the LOCO table library The user indicates the required action by placing an L in the action field to request LOCO load the table B in the action field to browse the member E in the action field to edit the member Standard ISPF statistics are maintained for the LOCO Table library Security Requirments To manipulate these resources requires READ access to the following SAF Profiles LOCO xxxx SSI to access the LOCO subsystem LOCO xxxx TABLES BROWS
90. 2 05 Displaying and Manipulating the TIME Queue The following screen is displayed when the user selects the TIME queue for manipulation J CDDF5100_MANUAL EXTRA Personal Client E lel x File Edit View Tools Session Options Help AA Logical Console Operator TSO Operator Interface Display Manipulate Time Queue for LOCA Command gt _ Scrol gt CSR 11 32 00 Has not been issued TIME 11 32 UNTIL 24 00 00 HITIME 24 00 00 WEEKDAY MTWTFSS ACTION CICSJOB1 ACTION gt CICSJOBZ2 ACTION gt DBCONTRL _ 15 40 00 Has not been is TIME CI5 40 00 UNTIL 24 Qo i HITIME 24 00 00 WEEKDAY MTWTFSS CPUID NTCI ACTION SCAFCQQ 1 _ 17 00 00 Has not been i TIMECI7 00 00 UNTIL 24 o r HITIMEC24 00 00 WEEKDAY MTWTFSS ACTION SHUT Q1 ACTION SHUT Q2 ACTION eSHUTOO3 6 17 20 00 Has not been issued TIME 17 20 00 UNTIL 24 00 00 HITIME 24 00 00 WEEKDAY MTWTFSS ACTION amp DBCTOO 18 00 00 Has not been issued TIMECI8 00 00 UNTIL 24 00 00 HITIME 24 00 00 MWEEKDAY MTWTFSS ACTION D J L 00 1 sus Connected to host 10 1 1 20 if T Rriaw From this screen the user can delete hold or release a specific entry on the LOCO time queue Each queue entry is formatted on multiple lines Before the beginning of a queue entry is an action field where the user specifies what action he would like LOCO to take against the following time queue entry
91. AFC e keywords found on d before the first ACTION keyword apply t TRACE Y N LUTI LUMSG nn D TERM EXCII EXC IMSG mm Ihe RC ON keyword apply only to that ACTI tch interfac Facility the CAFC bat CS Application Control DELAY HH MM SS DLAY HH MM SS FREEDSN Y N DEFACB Y N IRECT Y N ME HH MM SS CONNTYPE L E PAUSE HH MM SS RC J CTLF ACTI RC I SESS NORESPONSE Af a within 2 minutes the message situation is often related to poor CI SESS of the CAFCCMD t CAFC is a International LON the CAFCCMD are and NORESPONSE keywords th ON user should Installation Manual MEOUT HH MM SS ME HH MM SS GNORE ACCUM ILE applid cntl file dsname ON CAFC Command GNORE ACCUM ON CONT END ter LOCO issues a RECEI default limit of 2 minutes LOCO will VE WA II ME EXP REI D to CICS tu terminat iCEES required optional option option option option option option option option option option option option option required required optional optional optional it sets a timer with CS does not respond the request with NO RESPONSE This CS performance or to a data set being tied up by a user for an unusually long period
92. BControl commands that can be used as ACTION targets of other LOCO commands Ihe general se either through tup of tables for use by LOCO can be accomplished batch on TSO Ihe general se steps 1 Code a LOCO control tab rules 2 Run the LOCO table object LOCO control tabl SPF tup procedure for setup of LOCO through batch has 3 e following the statement syntax builder program LOCOBLDR to produce an Cz 3 Execute LOCO using the control table You may have many different LOCO control tables perhaps for different work shifts or different days of the week You may manually or automatically change the control table s currently in use at any time The general setup procedure for setup of LOCO through TSO has 3 steps Copyright 2004 Proprietary Product of NETEC International Inc Page 9 Logical Console Operator User Manual 11 12 05 1 Code a LOCO control rules through the TSO I 2 The LOCOBLDR process wil interactive tabl LOCO control tabl object tabl S e following the statement syntax PF LOCO table maintenanc devel Lopment process e scr l be accomplished as part of This will produce an ns the 3 Execute LOCO using the control table or ask LOCO to load the You may have many new table through control tables erent days of the week different LOCO shifts or diff automatically ch
93. CDDF5100 MANUAL EXTRA Personal Client E laj xl File Edit View Tools Session Options Help Menu Utilities Compilers Options Status Help ISPF Primary Option Menu Option O Settings Terminal and user parameters User ID P398 1 View Display source data or listings Time 16 84 2 Edit Create or change source data Terminal 3278 3 Utilities Perform utility functions Screen 1 4 Foreground Interactive language processing Language ENGLISH 5 Batch Submit job for language processing Appl ID ISR 6 Command Enter TSO or Workstation commands TSO logon ISPFPROC 7 Dialog Test Perform dialog testing TSO prefix 8 SDSF Spool Display and Search Facility System ID NTC1 9 LM Facility Library administrator functions MYS acct ACCT 18 IBM Products IBM program development products Release ISPF 5 8 11 SCLM SH Configuration Library Manager 12 Workplace ISPF Object Action Workplace L Loco Logical Console Operator Interface N Network Print Network Print Facility M More Additional IBM Products Enter X to Terminate using log list defaults 17 00 1 19 72 Connected to host 10 1 1 20 4 14 PM Proprietary Product of NETEC International Inc Copyright 2004 Page 26 Logical Console Operator User Manual 11 12 05 The following is a partial listing of the ISPFPROC from the previous example before it has been modified to include the LOCO libraries The changes have been indicated below The double dot
94. CE TYPE 4 SVCPARM 216 REPLACE TYPE 3 APF NO EPNAME SVCPARM 215 REPLACE TYPE 6 APF NO EPNAME SVCPARM 205 REPLACE TYPE 2 APF NO EPNAME SVCPARM 204 REPLACE TYPE 4 APF NO SVCPARM 203 REPLACE TYPE 2 APF NO EPNAME SVCPARM 202 REPLACE TYPE 4 APF NO Below the example has been SVC is 252 SVCPARM 255 RE SVCPARM 254 REE SVCPARM 252 RE IGC203 SVCPARM 216 RE SVCPARM 215 DFHCSVC SVCPARM 205 DFHHPSVC SVCPARM 203 I1GC205 m E fH E E U FU FU U Uu g fg y g D Q R R SVCPARM 204 REE R R SVCPARM 202 The LOCOSVC load to act as an SVC modifications to following is an INCLUDE LIBRARY SYS1 CICSTS23 CICS SDFHLPA example of an MODULES DFHCSVC DFHDSPEX DFH9 9SVC DFHDUMPX DFHIRP Proprietary Product of NETEC International Inc 1GC203 YPE 2 YPE 4 TYPE 3 APF NO EPNAME LOCOSVC YPE 3 APF NO EPNAME YPE 6 APF NO EPNAME YPE 2 APF NO EPNAME YPE 4 APF NO YPE 2 APF NO EPNAME YPE 4 APF NO module must be pl This can the that is currently in use at your installation IEALPAxx member befor the LOCOSVC definition has been added IMS 4 1 IMS 4 1 ECICS 6 2 CICS 6 2 7 IMS 6 1
95. CTION R2 D2 PAYROLL FAILED IN STEP Example 2 TELLOCO2 EXEC PGM LOCOINTF PARM SSN xxxx COND O GT STEP3 SYSIN DD PAYROLL STEP 3 FAILED NOTIFY BO DEREK Corresponding LOCO table statements might be WTO PAYROLL STEP FAILED ACTION R2 D2 PAYROLL FAILED IN STEP WTO NOT 4B Y SIERE ARE IS REA BRIE KR IE AR AOR AIR ACTION R2 D2 CALL PROGRAMMER XO k xx KK CK KK KK IG WTO NOTIFY BO DEREK ACTION R2 D2 PHONE NUMBER 222 4444 WTO NOTIFY BILLY KIDD ACTION R2 D2 PHONE NUMBER 1119999 WIO NOTIFY FREDDY FIDDLER ACTION R2 D2 PHONE NUMBER S330 TET Proprietary Product of NETEC International Inc Copyright 2004 Page 95 Logical Console Operator User Manual 11 12 05 Note You must tell LOCOINTF which LOCO to pass the messages to by the PARM SSN xXxXxx Creating Custom LOCO Actions via User Exit Programs User exit programs must be written in Assembler The calling sequence is standard R1 one word parm list R13 gt SAVEAREA in LOCOMAIN R14 return point in LOCOMAIN R15 beginning of exit program parm list parm 244 byte area L1 DS H length of input data max 110 bytes D1 DS CL120 lt input data L2 DS H
96. CTION will be performed as soon as EITHER wait condition is satisfied The wait keywords are functionally connected by a logical OR operator e is of the format HH MM SS and represents an of time not a clock value A RESET may be nly after a WAITEXT and specifies an amount of Proprietary Product of NETEC International Inc Page 78 Logical Console Operator User Manual 11 12 05 time after which LOCO is to automatically terminate the WAITEXT and recycle the LOCO table entry without executing any of the following ACTIONs The table entry will then wait for the time of the next REPEAT interval SET SET is an ACTION keyword used to insert values into user SVARS There are 32 user Svars labeled UV41 SUV 2 SUV 32 The symbol must immediately follow the user VAR label All text following the symbol including other global vars and blanks will become the current value of the target user var preceding the symbol Proprietary Product of NETEC International Inc Copyright 2004 Page 79 Logical Console Operator User Manual 11 12 05 COMMAND Statement The text is any string of characters including the WILDCARD This statement delineates an action or series of actions to be performed by LOCO whenever the COMMAND text is keyed on the MVS console The first character of the text must be the LOCO command prefix as specified on the DEFINE statement
97. Console Operator User Manual 11 12 05 Parameter Values Description HIDATE SIMULATE mm dd yyyy This fiel is specified in the LOCOMA ld specifies th LOCO is to use for this report This fiel execution The presence of the S N PARM instructs LOCO LOCOMA mode actions during this execution of LOCO LOCOMA N will record all actions that would have normally taken during this execution but the actual commands and actions will not be issued or actions Simulate mode is useful when you want check actions that wer that LOCO tables are taking the nded in the real int execution environment MULATE keyword in to simulate all d is required if the REPORT keyword N PARM field nding date that the I taken to Copyright 2004 Proprietary Product of NETEC International Inc Page 40 Logical Console Operator User Manual 11 12 05 Reporting and Simulating LOCO Actions LOCO has the ability to execut ither in a simulation or a reporting mode These modes are specified to LOCOMAIN by specifying SIMULATE for simulation mode or REPORT for report mode in the LOCOMAIN PARM field When LOCO is executing in report mode LOCOMAIN will process the LOCO table specified by the MEMBER parameter value as if it had been executed either on the DATE parameter or from the LODATE parame
98. Copyright 2004 JOB NOT FOUND A submit gt command was issued from the console or from an LCON ACTION but the specified job was not found in the submit library defined by ddname SUBMIT Insure that the JCL for LOCOMAIN has a proper definition for the SUBMIT DD statement Insure that the jobname to be submitted was spelled correctly TABLE MEMBER S When LOCOMAI NULL N attempted to read the specified member from ddname TABLE the member was found but it had no records Insure that the table name is spell Insure that the library defined by the JCL ddname TABLE is the correct LCON table library and that the requested table has been compiled by LOCOBLDR into that library ed correctly TIME OERAND REQUIRED A HOLD or RELEASE command was issued from the console or from an LCON ACTION but the TIME Operand was not coded The TIME operand is required for consistency with other LCON commands Provide the required TIME operand ERROR CODE NOT KNOWN Invalid code in ERROR command for testing LCON error recovery None This command is Xxxx ALREADY EXECUTING LOCOMAIN attempted to start for subsystem name XXxx but found that subsystem xxxx was marked LOCOUP There is apparently another LOCOMAIN in execution for subsystem xxxx If you wish to run multiple LCON subsystems each must its own subsystem
99. D NG FROM THE JCL The user has specified th Correct the error and s execution IMPORT control card and the D keyword is not found ubmit INI D DD key word on an DNAME specified in in the JCL for the the job for EITHER TABLE Neither on card Correct th execution TABLEDD AN TABLEDD an statement and one mu Correct th execution D the TABLED the LOCO import D TABLE d TABLE D OR TABLE DSN S REQUIRED D or TABLED export ul tility SN keyword was found IMPORT control One of the keywords is required e error and submit TABLEDD M SS The user has specified th IMPORT control card and the D keyword is not the TABLED the job NG FROM THE JCL Correct the error and submit execution DSN ARE MUTUALLY EXCLUSI The LOCO import export utility has found both DSN keywords on an These keywords are mutually exclusive st be removed e error and submit the job for TABLE D fo THE MEMBER KEYWORD Th impor SSR EQU RED member keyword is req t export utility Correct the error and submit execution THE Th MEMBER CAN NOT BE FO member specified in LOCO import export utility UNI D cannot be found Correct the error and submit
100. E to display the LOCO table entries LOCO xxxx TABLES EDIT to edit the LOCO table entries LOCO xxxx TABLES LOAD to request LOCO load the table entry XXXX The one to four character LOCO subsytem name Proprietary Product of NETEC International Inc Copyright 2004 Page 114 Logical Console Operator User Manual 11 12 05 Browsing a LOCO Table The following screen will be displayed when a B is entered in front of a member name in the manipulate LOCO tables member name list The LOCO table will be displayed using standard ISPF browse Normal ISPF browse keys are active during this session The user can scroll up and down browsing the selected table The END or CANCEL command will terminate the browse session and return to the manipulate LOCO Tables member list screen J CDDF5100_MANUAL EXTRA Personal Client E l81 x File Edit View Tools Session Options Help BROWSE NETEC LOCO33 TABLESCTESTTABL Line 00000000 Col 001 080 Command gt Scroll gt CSR XXXXHRRINMOUOOOOOOOOOGOOOGUUOUUOO Top of Data XHXWHHRERREOEXKRUUOUOOUUOOOEO EE REA ama i a kl lc m acd x 0010000 x x 02020000 x THIS TABLE TRIES TO CREATE ONE ENTRY OF EACH KIND x 00030001 x WITH ALL OPTIONS SPECIFIED THIS TABLE CAN BE USED x 00040001 x TO CREATED FULL FUNCTION ENTRIES THAT CAN BE DUMPED x 00050001 x IN THE LOCOMAIN ADDRESS SPACE x 00060001 x x 00070001
101. E DUE TO PREVIOUS FORCE This is an information message indicating the LOCO LOAD LOCODBCT none DB Control subtask has removed pending actions due to an operator action that FORCE of the current LOCO table DB Control required a Proprietary Product of NETEC International Inc Page 189 Logical Console Operator User Manual 11 12 05 LCONO740 Explanation Issued by User Response LCONO741 Explanation Issued by User Response LCON0743 Explanation Issued by User Response LCON0744 Explanation Issued by User Response LCON0746 Explanation Issued by User Response LCON0747 Explanation Issued by User Response Copyright 2004 LIBRARY COMPRESSION SUBTASK BEGINNING NITIALIZATION This is an information message indicating the library compression subtask is beginning initialization LOCOCPRS none LIBRARY COMPRESSION SUBTASK TRACE ACTIVATED This is an information message indicating the library compression subtask has activated internal trace LOCOCPRS none LIBRARY This is library tracing LOCOCPRS none COMPRESSION SUBTASK TRACE DEACTIVATED an information message indicating the compression subtask has stopped internal LIBRARY COMPRESSION SUBTASK BEGINNING TERMINATION This is an information message indicating the library com
102. EC International Inc to the installation s MVS ARM policy Page 15 Logical Console Operator User Manual 11 12 05 Installation Detail Step 1 Load the four distributed PDS files to your disk using TEBCOPY LOCOCOPY JOB Jiuwkedueieeeve FILE EXEC PGM IEBCOPY SYSPRINT DD SYSOUT SYSUT1 DD DSN LOCO LOAD LIBRARY DISP OLD UNIT TAPE VOL SER XXXXXX lt insert LOCO tape volser LABEL 1 EXPDT 98000 SYSUT2 DD DSN your load pds DISP NEW CATLG DELETE UNIT SYSDA VOL SER Vvvvvv SPACE CYL 2 1 10 RLSE DCB RECFM U BLKSIZE 6144 SYSUT3 DD UNIT SYSDA SPACE CYL 1 1 SYSUT4 DD UNIT SYSDA SPACE CYL 1 1 SYSIN DD COPY I SYSUT1 O SYSUT2 FILE2 EXEC PGM IEBCOPY SYSPRINT DD SYSOUT SYSUT1 DD DSN LOCO SOURCE LIBRARY DISP OLD UNIT TAPE VOL SER XXXXXX lt insert LOCO tape volser LABEL 2 EXPDT 98000 SYSUT2 DD DSN your source pds DISP NEW CATLG DELETE UNIT SYSDA VOL SER vvvvv
103. ETEC International Inc Copyright 2004 Page 24 Logical Console Operator User Manual 11 12 05 can be eliminated on the SETSSI is not being used for authorization SETSSI A D D SUBNAME xxxx IN IRTN LOCO command if the LOCO SVC N Where xxxx LOCO Subsystem name Copyright 2004 yyy Proprietary Product of NETEC International Inc T INITPARM yyy The LOCO SVC number for authorization Page 25 Logical Console Operator User Manual 11 12 05 Step 6 Install the LOCO TSO Interface a Modify the TSO procedure to include the LOCO TSO Interface Program libraries The following libraries should be concatenated with the libraries found with the corresponding DDNAMEs Exercise caution when modifying the TSO procedure If a mistake is made that will cause a JCL error a TSO user will not be able to logon using the modified procedure DDNAME Library STEPLIB your load pds SPPLIB your ispf ispplib SPMLIB your ispf ispmlib To determine the TSO procedure that a TSO user is currently using enter the primary option menu of ISPF The screen should look similar to the following example On the right side of the screen is a field labeled TSO logon This field contains the TSO procedure name that is most likely the one to be modified In the following example the TSO procedure name is ISPFPROC zd
104. FA LE exit program mechanism Attempt to run LOCOMA cont error persists Proprietary Product of NETEC International Inc N in a larger region tact NETEC Technical Support D IN in a larger region tact NETEC Technical Support If Page 175 Logical Console Operator User Manual 11 12 05 LCON0146 Explanation User Response LCON0147 Explanation User Response LCON0148 Explanation CALLED PROGRAM BLDL FAILED LOCOMAIN issued a program and the If error persists Support contact CALLED PROGRAM LOAD FAI LED LOCOMAIN issued a LOAD macro for and the macro failed program If error persists Support contact BLDL macro for macro failed a user exit Technical NETEC a user exit NETEC Technical GETMAIN FATLED FOR SUSPEND LOCOMAIN was attempting to of a command The getmain ELEMENT COMMAND IGNORED suspend the execution for storage that is necessary to suspend command has been ignored Reissue the command User Respons LCON0149 Explanation User Response the command has fails so the EXECUTION OF QUEUE ENTRY FAII BEEN RELOADED Fr D BECAUSE TABLE HAS An attempt to execute a LOCO command through the TSO interface has been attempted the LOCO commands were to the TSO user so the command ex
105. INACTIVE REVERSE INIT IS REQUIRED Explanation The LOCO subsystem that who is being initialized is not currently active A reverse initialization can be executed to remove the LOCO subsystem User Response Execute a reverse initialization Proprietary Product of NETEC International Inc Copyright 2004 Page 194 Logical Console Operator User Manual 11 12 05 LCON0814 Explanation User Response LCON0815 Explanation User Response LCON0816 Explanation User Response LCON0817 Explanation SUBSYSTEM IS ACTIVE The LOCO subsys tem that is being ini tial is currently active Stop the current to initialize t LOCO subsystem and OPEN FAILURE NG STEPLIB DDNAME then attempt The LOCO subsystem has attempted to open the STEPLIB DDNAME process Correct An error the error and restart LOCO BLDL FAI in the STEPLIB LED TRY The LOCO subsys has occurred during this ING TO LOCATE LOCOSSSM tem cannot find the LOCOSSSM module DDNAME Place the library that contains the LOCOSSSM program into the LOCOMA N STEPI GETMA N FA LED FOR RESI DENT LOCOSSSM B concatenation The LOCO subsystem has attempted to obtain storage for the LOCOSSSM program and the GETMAIN for storage has failed User Respons LCON0818 Explanation
106. KEYWORD IS TOO LONG FOUND XXXXXXXXXXXX The statement syntax checker expected to find an Operand keyword but found a string of text which is too long to be a keyword operand Correct the incorrect keyword operand EXPECTED CONTINUATION CARD DISAPPOINTED BY EOF The previous statement indicated a continuation but end of file was encountered instead Either provide the proper continuation card or remove the continuation indicator from the previous card EXPECTED BEFUDDLED BY GARBAGE XXXXXXXXXXXX The statement syntax checker expected to find a left parentheses but found XXXXXXXXXXXX instead There must always bea between a keyword and its value Provide the left parentheses Proprietary Product of NETEC International Inc Page 160 Logical Console Operator User Manual 11 12 05 LCON0012 Explanation User Response LCON0013 Explanation User Response LCONO014 Explanation User Response LCONO015 Explanation User Response LCON0016 Explanation User Response LCON0017 Explanation User Response Copyright 2004 XXXXXXXXXXXX YYYYYYYYYYYY The value yyyyyyyyyyyy for keyword operand XXXXXXXXXXXX is less than the minimum acceptable value Correct the operand value IS LESS THAN MIN VALUE FOUND XXXXXXXXXXXX VALUE SPANS TOO MANY CARDS The value of an operand may span at most t
107. KKKKKKKKKKKKKKKKKKKRRKKK Top of Data XMXXKKHKKXXKNXKNEXXKRNXKKEXXKRNEXKM Q10000 4 x 020000 x x 030001 x THIS TABLE TRIES TO CREATE ONE ENTRY OF EACH KIND x 040001 x WITH ALL OPTIONS SPECIFIED THIS TABLE CAN BE USED x 050001 x TO CREATED FULL FUNCTION ENTRIES THAT CAN BE DUMPED x 062001 x IN THE LOCOMAIN ADDRESS SPACE x 070001 x x 80000 4 x 09000A DEFINE CARDSIZE 72 100000 PREFIX 110000 QLIMIT 200 120000 SLEEP 00 00 00 130000 WILDCARD x 150000 STARTUP 160001 ACTION K E D L 01 170001 WAITTIME Q0 01 00 180001 ACTION K A NONE L 01 190001 WAITEXT HAITTEXT 200001 RESET 02 00 00 210001 ACTION K A NONE L702 00 1 02 15 met Connected to host 10 1 1 20 11 59 AM If the user has modified the table and has entered the END command or presses PF3 the LOCO compilation process will be automatically started At the completion of the LOCO table compile the output from the compile process will be made available to the user through standard ISPF browse The user can scroll through the output and determine if the compile was Proprietary Product of NETEC International Inc Copyright 2004 Page 116 Logical Console Operator User Manual 11 12 05 successful The following is an example of the output of the compile process J CDDF5100_MA
108. L ecution of the LOC O subsystem is value is the to ots defined for th CO This value is MIT parameter on tal number of is execution of specified as the the DEFINE card This value represents the total number of message LOCO could not process due to exceeding the QL co Th th Th ac th Th in Th in Th is TH actions taken Th is Th detected Th re time it unt on the DEFINE is field contains at LOCO iss was issued ese fields represe tivity LOCO has en is execution is value is 1 tercepted is value is t tercepted is value is t sued is valu e nu e nu e nu e is the nu e is th LOCO e is th is valu sued by is valu e nu e nu is value is th issued a WTO e nu ued and MIT card the lst command the date and nt the message countered during mber of WTOs mber of WTORs mber of commands mber of LOCO mber of replies mber of abends mber of times LOCO Proprietary Product of NETEC International Inc Copyright 2004 Page 111 Logical Console O perator User Manual 11 12 05 Trace Status Master Trace gt Trace all WQE OREs gt Trace CICS activity gt Trace al ll messages gt Security Requirments To issue the LOCO status command requires REA following SAF Profiles The following fi
109. L 4 PANEL ISRFPA SCRNAME FOREGRND Proprietary Product of NETEC International Inc Copyright 2004 Page 29 Logical Console Operator User Manual 11 12 05 5 PGM ISRJB1 PARM ISRJPA SCRNAME BATCH NOCHECK 6 PGM ISRPTC SCRNAME CMD 7 PGM ISPYXDR PARM amp ZTAPPLID SCRNAME DTEST NOCHECK 8 PANEL ISRLPRIM SCRNAME LMF 9 PANEL ISRDIIS ADDPOP 10 PGM ISRSCLM SCRNAME SCLM NOCHECK 11 PGM ISRUDA PARM ISRWORK SCRNAME WORK X EXIT SP PGM ISPSAM PARM PNS r HOLD amp ZTRAIL TRAIL PNTS END The following is a partial listing of the modified ISPF primary option The changes have been indicated below The double dots indicate missing lines of information that have been removed to shorten the listing PANEL KEYLIST ISRSAB ISR IMAGE amp ZIMGNAM amp ZIMGROW amp ZIMGCOL ATTR DEFAULT FORMAT MIX ISR PRIM ENGLISH 5 0 OB TYPE AB OD TYPE PS 04 TYPE ABSL GE ON AREA SAREA39 0 Settings Terminal and user parameters 1 View Display source data or listings 2 Edit Create or change source data 3 Utilities Perform utility functions 4 Foreground Interactive language processing 5 Batch Submit job for language processing 6 Command Enter TSO or Workstation commands 7 Dialog Test Perform dialog testing 8 LM Facility Libr
110. LOCO Queues The following screen is displayed when option 6 is entered from the selection menu The screen lets the user select which LOCO queue he would like to manipulate CDDF5100_MANUAL EXTRA Personal Client P laj xj File Edit View Tools Session Options Help aee eas Logical Console Operator TSO Operator Interface Display Manipulate Queues for LOCA Option gt _ Manage Time Queue Manage WTO Queue Manage WTOR Queue Manage Startup Queue Manage Shutdown Queue Manage Events Queue Manage Command Queue TJ C Cn EA wN A licensed proprietary product of NETEC International Copyright 2002 00 1 04 14 Connected to host 10 1 1 20 inal fiiia The queues that may be selected ar Queue Name Description Time Actions waiting for a specific time and date to occur WTO Actions waiting for a specific WTO to be issued WTOR Actions waiting for a specific WTOR to be issued Startup Actions to occur at LOCO start up time Shutdown Actions to occur a tLOCO shut down time Events Actions to occur when specific end of job events occur Proprietary Product of NETEC International Inc Copyright 2004 Page 128 Logical Console Operator User Manual 11 12 05 Command Commands that may be issued by the user or as a target of a LOCO ACTION Proprietary Product of NETEC International Inc Copyright 2004 Page 129 Logical Console Operator User Manual 11 1
111. LOCO Trace The following screen is displayed when option 2 is entered from the selection menu The screen allows the user to start and stop LOCO internal traces CDDF5100_MANUAL EXTRA Personal Client E laj xj File Edit View Tools Session Options Help E Logical Console Operator TSO Operator Interface Manipulate Trace for LOCA Command gt _ Master Trace gt ON Trace all WQOE OREs gt OFF Trace CICS activity gt OFF Trace all message gt OFF 6 00 1 03 15 Trace status is changed by keying ON or OFF into the field next to the type of trace field The following describes the types of internal traces the user can GOntrol Master Trace gt This field instructs LOCO to either activate or deactivate the master internal trace Trace all WQE OREs gt This field instructs LOCO to either activate or deactivate the tracing of all WOES OREs Proprietary Product of NETEC International Inc Copyright 2004 Page 121 Logical Console Operator User Manual 11 12 05 Trace CICS activity gt This field instructs LOCO to either CICS activity activate or deactivate the tracing of Trace all message gt This field instructs LOCO to either activate or deactivate the tracing of all messages Security Requirments To manipulate these resources requires READ access to the following SAF Profiles
112. LOCO initializes LOCOMAIN registers with ARM If your installation s ARM policy specifies restart rules for LOCO it will be restarted in the event of a failure according to these rules For additional information on ARM and the definition of ARM policies please refer to the IBM document MVS Setting Up a Sysplex GC28 1779 LOCO utilizes the following ARM element names and element types ARM Element Type LOCO ARM Element Name LOCO_xxxx XXXX is the LOCO susbsytem name of the LOCO that is registering with ARM Proprietary Product of NETEC International Inc Copyright 2004 Page 35 Logical Console Operator User Manual 11 12 05 Getting Started Analyzing SYSLOG to create LOCO Tables The LOCOLOG job reads a copy of your SYSLOG data set and lists all WTO R s and REPLYs together It sorts all WTO R s by message number to provide potential candidates for LOCO automatic action ANALYSE JOBY quare epe decere e ana LOG EXEC PGM LOCOLOG REGION 1024K PARM nnn STEPLIB DD DSN your loco loadlib DISP SHR SORTLIB DD DSN SYS1 SORTLIB DISP SHR SYSPRINT DD SYSOUT SYSOUT DD SYSOUT SORTMSG DD SYSOUT SORTWKO1 DD DSN amp SORTWK1 UNIT SYSDA SPACE CYL 1 1 SORTWKO2 DD DSN amp SORTWK2 UNIT SYSDA SPACE CYL 1 1
113. LOCOMAIN The LOCOBLDR process is automatically invoked when a LOCO tables has been modified through the LOCO TSO ISPF interface COMPILE UO cigs casa ahpr widen ete whup Bb ain ac a weds BUILDER QOXEC PGM LOCOBLDR REGION 1024K STEPLIB DD DSN your loco loadlib DISP SHR SORTLIB DD DSN SYS1 SORTLIB DISP SHR SYSPRINT DD SYSOUT SYSOUT DD SYSOUT SORTIN DD DSN amp SORTIN UNIT SYSDA SPACE CYL 4 1 SORTOUT DD DSN amp SORTOUT UNIT SYSDA SPACE CYL 4 1 DCB RECFM FB LRECL 150 BLKSIZE 6000 TABLE DD DSN your loco table library tabname DISP SHR SYSIN DD LOCO source control table Notes 1 The SORTLIB statement is not necessary if SORTLIB is in your LNKLST 2 The STEPLIB statement is not necessary if you have LINKed LOCOBLDR into a LNKLST library Bis The SYSOUT statement is for SORT messages and can be changed to DD DUMMY 4 The SYSIN statement is for the input source control table it may be specified as a PDS and member name LOCOBLDR expects 80 byte records blocked as you wish Sus The TABLE statement is the output object control table in 150 byte records blocked up to 20k bytes LOCOMAIN uses this same data set as input and has it
114. Logical Console Operator Version 3 3 00 COPYRIGHT 2004 ALL RIGHTS RESERVED NETEC International Inc P O Box 180549 Dallas Texas 75218 0549 Telephone 214 343 9744 Telefax 214 343 9009 Email support netec2000 com Logical Console Operator User Manual 11 12 05 This page intentionally blank Proprietary Product of NETEC International Inc Copyright 2004 Page 2 Logical Console Operator User Manual 11 12 05 TABLE OF CONTENTS TIVE COUT LOM x tase Ste fice hen Se cater tal er tro etude te ua o e Wine canta ne ce het Ses cote al oe Qaia se fe 6 Operat iona l OVERVIEW sche EE baa We SER RU Sas uA Sa SUR et oaks 9 Processing Narrative ool eed Gee bedi ae ee ed cred Eu ncetronaLl Drdgradm i me eee eee Ae Se RS Ae ee eRe dee Seed Tnstaldation GUidG sce x e Uedyde dk m Ge EUR ir avd Be Wee E EAS WU ace Oe wie wee AD Distribution TAOS sas seeded Sie Pee heed eases eese hod eren ie ee Ga he Installadtuzon OV ELV LEW zeuceg eckdeuctUeece RE LS an Mae ay titan bane ab wee ee m Tnstalilatron Details austere Cuetec Meath wie Sues esu io Gerin orar ed P m 36 Analyzing SYSLOG to create LOCO Tables 2 eee ee eee 36 Lnrtuzxalrzrng the COCO SUDSYSUEMS 1 24 2iieed oe 2h deed Ee ede wed es 37 Specifying the Operational Characteristics of LOCOMAIN 38 Reporting and Simulating LOCO ACTIONS wir
115. Monday keyword JOBNAME jobnames ters represents th tions wil It is a filte ll NOT be aracter woul Ihe value must follow the MVS JCL requ ld cause the WTOR irements If YY is in the range of 00 then the century will be set to 20 then the century will e seven days of r performed on actions Tuesday and Wednesday only for It is a filter keyword the WTOR actions will be performed only for MVS jobs with matching jobnames which issue the WTOR text JOBNAME value may The filter condition may be reversed by preceding the jobname value by contain WI LDCARD characters minus symbol JOBTYPE Copyright 2004 E G J OBNAME OPER1 A JOB TSU MSTR ES3 Ihe jobtype must be one of the following strings JES2 J Proprietary Product of NETEC International Inc the SIC It is a filter keyword Page 74 Logical Console Operator User Manual 11 12 05 CPUID TSOID ORIGIN WTOR actions will only be performed for WTORS issued by subsystem MSTR JES2 JES3 or type of job STC JOB TSU The filter condition may be reversed by preceding the jobtype value by the minus symbol E G JOBTYPE JOB The cpuid is a four digit value representing the internal MVS id of the cpu It is a filter keyword WTOR actions will only be performed when LOCO is invoked on t
116. N greater than 120 An EVENT statement specified an event unknown to LCON Correct the EVENT statement SYMBOL PRECEED NG CALLED EXPECTED LOCOBLDR found exit program call in the syntax was incorrect Correct the syntax UNABLE TO FIND TERM NAT NG SYMBOL PROGRAM NAME Currently ENDOFSTEP is the only valid event PROGRAM NAME an ACT AFTER CALLED ON but LOCOBLDR found exit program call in the syntax was incorrect Correct the syntax CALLED PROGRAM NAME IS NULL LOCOBLDR found exit program call in the syntax was incorrect was missing Correct the syntax The exit Proprietary Product of NETEC International Inc an ACT an ACT ON but ON but progran Page n name 165 Logical Console Operator User Manual 11 12 05 LCONO045 Explanation User Respon LCON0046 Explanation User Respons se USER HAS SPEC F ED A RESERVE LOCOBLDR fo D COMMAN und that a LOCO reserved D NAME command name was specified for a user defined command th user specified comn Chang USER COMMANDS CAN NOT START WI und that a user defined LOCO command with a special LOCOBLDR fo name began Remove th LCON0047 Explanation User Respons Spcial nand name character the user d USER HA
117. NORED This is part of the STATUS command output that indicates WTOs issued by XCF for the sysplex are being ignored none Proprietary Product of NETEC International Inc Page 179 Logical Console Operator User Manual LCONO172 Explanation User Response LCONO173 Explanation User Response LCONO174 Explanation User Response LCON0175 Explanation User Response LCON0176 Explanation User Response WTO177 DC DC CSA OX LCONO179 LCON0180 Explanation User Response Copyright 2004 11 12 05 WAITING FOR ACTIVE LOCO has been ask to subtask is busy processing a DBCONTROL SUBTASK TO COMPLETE terminate and the DBCONTROL DBCTCMD command LOCO will wait until the DBCTCMD command is complete None VERSION x x mm dd yyyy X X is the LCON release number mm dd yyyy is the assembly of program module LOCOMAIN None REPLIED TO xxxx YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY The text yyyyyyyyyyyyyyyyyyyy was issued as a reply to reply number xxxx by LOCOMAIN None TABLE XXXXXXXX yyyy ddd hh mm ss The LCON table initially loaded is XXXXXXXX It was compiled by LOCOBLDR on date yyyy ddd at time hh mm ss None WAITING FOR ACTIVE LOG SUBTASK TO COMPLETE LOCO has been ask to terminate and the active log subtask is busy processing a logging request LOCO will wait until the log request co
118. NUAL EXTRA Personal Client lel x File Edit View Tools Session Options Help BROWSE SYS 2292 7115049 RAQ 0 UZTEC8 RA100961 Line 00000000 Col 201 Command gt _ Scroll gt C XKXNXNXMIOUOOOOOOOOOOOOOOOOOOOOUO Top of Data KKXEUOXI4GOOOOUOOOOOOOEO REOR UN LCON 4 LCON BUILDER VERSION 3 3 07 20 2002 THIS TABLE TRIES TO CREATE ONE ENTRY OF EACH KI WITH ALL OPTIONS SPECIFIED THIS TABLE CAN BE TO CREATED FULL FUNCTION ENTRIES THAT CAN BE DU IN THE LOCOMAIN ADDRESS SPACE DEFINE CARDSIZE 72 PREFIX QLIMIT 200 SLEEP 00 00 00 WILDCARD G29 03 17 mm Connected to host 10 1 1 20 11 59 AM If the user enters the END command or presses PF3 and the table compile was successful the user will be prompted with the following popup panel Proprietary Product of NETEC International Inc Copyright 2004 Page 117 Logical Console Operator User Manual 11 12 05 J CDDF5100_MANUAL EXTRA Personal Client EF le x File Edit View Tools Session Options Help rt NETEC LOCO33 TABLES TESTTABL COLUMNS eer CSR Command gt _ KRRKRRRKRRK Please confirm the replacement of LOCO table TESTTABL in NETEC LOCO33 TABLES Instructions TK OOK CK OK OOK OK Press enter to confirm the replacement of LOCO table TESTTABL x Enter CREATE member name to create a new LOCO table Enter REPLACE member name to replace an existing LOCO table Enter END EXIT or PF3 to return to edi
119. O FORCE TERMINAT REQUEST This is an information message indicating the LOCOCAFC subtask has interrupted a current execution of a CAFCCMD due to an operator action that required a LOAD FORCE of the current LOCO table LOCOCAFC none NG EXECUT ON OF CAFCCMD REMOVING CAFC QUEUE ENTRY FROM THE LOCOCAFC WORK QUEUE DUE TO PREVIOUS FORCE This is an information message indicating the LOCOCAFC subtask has removed pending CAFC actions due to n operator action that required a LOAD FORCE of the current LOCO table LOCOCAFC none Proprietary Product of NETEC International Inc Page 187 Logical Console Operator User Manual 11 12 05 LCON0720 DB CONTROL INTERFACE SUBTASK BEGINNING NITIALIZATION Explanation This is an information message indicating the LOCO DB Control subtask is beginning initialization Issued by LOCODBCT User Response none LCONO721 DB CONTROL INTERFACE SUBTASK TRACE ACTIVATED Explanation This is an information message indicating the LOCO DB Control subtask has activated internal trace Issued by LOCODBCT User Response none LCON0723 DB CONTROL INTERFACE SUBTASK TRACE DEACTIVATED Explanation This is an information message
120. O queue Each queue entry is formatted on multiple lines Before the beginning of a queue entry is an action field where the user specifies what action he would like LOCO to take against the following WTO queue entry The valid actions that can be specified for a queue entry are Action Description H Hold the WTO queue entry Prevent LOCO from taking action should actions required to execute this queue entry be meet Proprietary Product of NETEC International Inc Copyright 2004 Page 132 Logical Console Operator User Manual 11 12 05 Release the WTO queue entry Release LOCO to take action should actions required to execute this queue entry be meet Delete this WTO queue entry LOCO will remove the entry from the WTO queue To replace th ntry in the queue will require the LOCO table be reloaded Security Requirements To manipulate these resources requires READ access to the following SAF Profiles LOCO LOCO LOCO LOCO XXXX Copyright 2004 XXXX SSI to access the LOCO subsystem XXXX QUEUES WTO BROWSE to display queue entries XXXX QUEUES WTO HOLD to HOLD RELEASE queue entries XXXX QUEUES WTO DELETE to DELETE queue entries The one to four character LOCO subsytem name Proprietary Product of NETEC International Inc Page 133 Logical Console Operator User Manual 11 12 05 Displaying and Manipulating the WTOR Queue Th
121. OPEN only during actual table loading initialization and LOAD command If you specify DISP SHR then you may compile LOCO control tables while LOCOMAIN is running Creating LOCO Tables with the LOCO TSO ISPF Interface LOCO tables can be created through the LOCO TSO ISPF interface by issuing the edit command E with a member name that does not exist The user can them enter the LOCO table source into ISPF until the table is complete At that time when the PF3 key is Proprietary Product of NETEC International Inc Copyright 2004 Page 46 Logical Console Operator User Manual 11 12 05 pressed the table will be passed through the LOCOBLDR process and saved in the table library Managing LOCO Table Source LOCOIMEX is a batch utility program to provide users with the ability to import and export LOCO table source into and out of the LOCO table library The following is an example of the basic JCL necessary to execute the LOCO table import export utility If the INDD OUTDD or TABLEDD keywords are utilized on the IMPORT and EXPORT commands DD statements must be added to the JCL stream for these data sets LOCOIMEX So EcL Eu STEP EXEC PGM LOCOIMEX REGION 1024K PARM TRACE FIE STEPLIB DD DSN your loco loadlib DISP SHR
122. RENTLY ACTI SABLED ON to execute a DB CONTROL support in LOCOMAIN is DB CONTROL The action has been ignored in DB CONTROL DB CONTROL support the action from the LOCO in LOCOMAI LOCOMAIN parm N ATTEMPTING TO REG STER W MANAGER LOCOMA IH THE AUTOMATIC RESTART IN is in the process of registering with the MVS automatic restart manager None REGISTRAT ON W SUCCESSFUL LOCOMA automatic restart manager None THE LOCO TABLE BE SUCCESSFULLY B ING LOADE IH THE AUTOMATIC RESTART MANAGER IN has successfully registered with the MVS D HAS NOT BEEN UILT BY LOCOBLDR LOCOMAIN has attempted to load a LOCO table that has not successful process the LOCO Edit Execute the LOCOBLI lly completed the LOCOBLDR table and correct any error DR process and reload the table Proprietary Product of NETEC International Inc Page 178 Logical Console Operator User Manual 11 12 05 LCON0166 Explanation User Response LCON0167 Explanation User Response LCON0168 Explanation User Response LCON0169 Explanation User Response LCONO170 Explanation User Response LCONO171 Explanation User Response Copyright 2004 LCON HAS EXPERIENCED A SYNCHRONUS DCB ERROR LOCOMAIN has encountered a severe e
123. RING EXPRESSION HAS INVALID SYNTAX The required syntax for Svariable substring expression is xxxxxx n m where xxxxxx is the Svariable label n is the beginning position and m is the length Provide a correct substring expression the Svariable XXXXXXXX SUBSTRING EXCEEDS MAXIMUM LENGTH The requested substring extraction represents characters beyond the maximum length of the particular Svariable If L is the maximum length of Svariable xxxxxx then your substring xxxxxx n m is such that nt m 1 gt L Provide a correct substring expression the Svariable XXXXXXXX NOT ALLOWED IN THIS STATEMENT TYPE The Svariable xxxxxxxx is not allowed in this User Respons LCON0035 Explanation User response LCON0036 Explanation User response Copyright 2004 statement because it cannot be evaluated Local Svariables require some triggering text WTO WTOR or COMMAND Remove the offending Svariable SYNTAX ERROR IN TSOID OF SEND COMMAND The required format to specify a TSOID in an LCON SEND command is S ttttttt xxxxxxxxxx The is your defined LCON command prefix the is the send command the surround the TSOID of the intended recipient ttttttt xxxxxxxxxx is the message text Specify a correct syntax SEND COMMAND HAS NO MESSAGE TEXT The text of the SEND command was f
124. RT EXPORT UTILITY S A PROPRIETARY PROGRAM FROM NETEC INTERNATIONAL COPYRIGHT 2004 This is an informational message None LOCO TABLE IMPORT EXPORT UTILITY BEGINNING EXECUTION AT HH MM SS ON MM DD YYYY IHIS PROGRAM IS EXECUTING DURING A TRIAL PERIOD IHAT WILL EXPIRE ON XX DD YYYY IHE TRIAL PERIOD FOR EVALUATING THIS PROGRAM HAS EXPIRED EXECUTION TERMINATING This is an informational message indicating the date and time the LOCO table import export utility is executing If the product is executing during a trial period the second message will be displayed informing the user of the t If the product is executing under a t and the trial period has expired th will be displayed and the execution o table import export utility will term rial period rial period third message f the LOCO inate None NVALID IGNORED The LOCO import export utility has fo data in the parm field on the EXEC st Remove or correct the information and job for execution DATA ENTERED N THE PARM FI ELI D DATA und invalid atement resubmit the ISO ENVIRONMENT SETUP FAILED RC XX An internal error has occurred during the initialization phase of the LOCO import export utility while attempting to setup the batch TSO environment Contact NETEC technical support READY FOR COMMAND INPUT This is an informational message N
125. S SPEC F ED A LOCOBLDR found specified more Create a n LCON0048 Explanation User Response Copyright 2004 defined commands GETMAIN FAILUR E LOCOBLDR has processing Rerun LOCOBLDR with a larger region size encountered an internal TH SPECIAL CHARACTERS character from the beginning of fined command DUPLICATE COMMAND NAME that a LOCO command name was than once w command name for one of the user error while If the problem continues contact NETEC Technical Support Proprietary Product of NETEC International Inc Page 166 Logical Console Operator User Manual 11 12 05 Messages from LOCOMAIN LCON0101 LCONO300 Messages are shown with LCON as the message prefix This prefix will be changed to the current subsystem name by LOCOMAIN at execution time If LOCOMAIN is run with PARM SSN LCON then the messages will be LCON101 LCON102 etc NOT ABLE TO OPEN XXXXXXXX Explanation Probably missing DD card for ddname Xxxxxxxx User Response Supply missing DD card PARM VALUE TOO LARGE MAX SIZE 79 BYTES Explanation Parm value is too large It may not be longer than 79 bytes User Response Remov xtraneous data from PARM LCONO101 SHUTDOWN AT CONSOLE REQUEST Explanation LCON has been requested to shutdown by the Q8 STOP command User Response None
126. S99T NETEC VSAM CAFC4300 AFCF0001 00251010 ACTION CICS99P C DD QAFCTO1 00260010 ACTION CICS99P C DD QAFCTO2 00270010 ACTION CICS99T C DD QAFCTO3 00280010 00180001 00190001 DB CONTROL COMMAND CONSTRUCTION 00200001 00210001 D 00220001 DBCTCMD DBCT001 00530001 IMSID IVP3 00540001 MAXRC 16 x 00541008 PSBNAME DBC9000 00542008 Proprietary Product of NETEC International Inc Copyright 2004 Page 157 Logical Console Operator User Manual 11 12 05 SUFFIX LD 00543008 WAITIME 1 00544008 RESPONSE WAIT 00545009 ACTION START DATABASE DI21PART 00550001 00180001 m 00190001 IMED ACTIONS 00200001 00210001 i 00220001 13 00 00 00570002 ACTION CAFC001 00570003 t 00180001 00190001 WTO INITIATED ACTIONS 00200001 X 00210001 i 00220001 WTO DFS9941 WARM START COMPLETED 00100900 JOBNAME DBCTL 00101000 ACTION QDBCTOO1 00101100 Proprietary Product of NETEC International Inc Copyright 2004 Page 158 Logical Console Operator User Manual 11 12 05 Error Messages Messages from LOCOBLDR Explanation User Response LCONO0001 Explanation User Response LCONOO02 Explanation User Response LCONO003 Explanation User Response LCONO004 Explanation User Response Copyright 2004 LCON0001 LCON0099 NOT ABLE TO OPEN XXXXXXXX Probably
127. SS would cause the WTO actions to be performed on Saturday and Sunday only JOBNAME Ihe value must follow the MVS JCL requirements for jobnames It is a filter keyword WTO actions will be performed only for MVS jobs with matching jobnames which issue the WTO text The JOBNAME value may contain WILDCARD characters The ACTION text may contain global or local vars for real time substitution The filter condition may be reversed by preceding the jobname value by the minus symbol E G JOBNAME FREDSJOB JOBTYPE CPUID TSOID ORIGIN Copyright 2004 Ihe jobtype must be one of the following strings STC JOB TSU MSTR JES2 JES3 It is a filter keyword WTO actions will only be performed for WTOS issued by subsystem MSTR JES2 JES3 or type of job STC JOB TSU The filter condition may be reversed by preceding the jobtype value by the minus symbol E G JOBTYPE SIC The cpuid is a four digit value representing the internal MVS id of the cpu It is a filter keyword WTO actions will only be performed when LOCO is invoked on that particular cpu The CPUID value may contain wildcard characters The filter condition may be reversed by preceding the cpu id value by the minus symbol E G CPUID CPUA The tsoid is a 7 digit value representing the TSO user id of the submitter of the job which produced the WTO triggering event
128. TEMENES leere pre tA aceite eb go eve dS Displaying and Manipulating the STARTUP Queue Security Requirements Security Requirements Security Requirements Security ReGgUulfementsgide unbedeguie dorus dokysw re UE Security for the LOCO ToO Inberfd3CO6 gce sg eeu had ME D Hints Tips Special Techniques and Examples Communicating with CICS from LOCO 4 2 2299 gw Running LOCQ before JES 2 iede Meade ong ved eA E E exe e dels SLEEP verses WALT UME oct ghee wits ies ok ate wile md ge ero de cR EU ae S EVE SU d CEU Grouping related eGvents 3dGuuxgdde aeu eer esee asd hee Roper Delayed reply to WOR wi wiewedde wed ae ehea we ab eue er dee ere Ei Red dene e Time RO GES excel dee Hen ial oS tae ol ee dias ne cia Ge tee thats tue tae ieee Stee nel Proprietary Product of NETEC International Inc Copyright 2004 Displaying and Manipulating the SHUTDOWN Queue Displaying and Manipulating the EVENT Queue Displaying and Manipulating the COMMAND Queue 11 12 05 C e OO ue C n C C C C n C C c C CO 0 001 45 4 C C P2 NY 1 3 N Co Oo OY O NNN OW e N co Ww WwW n Co N Co Co WwW D Co O1 W
129. TEXT and recycle the LOCO table entry without executing any of the following ACTIONs The table entry will then wait for the next occurrence of the original COMMAND text Proprietary Product of NETEC International Inc Copyright 2004 Page 80 Logical Console Operator User Manual 11 12 05 SET SET is an ACTION keyword used to insert values into user SVARS There are 32 user vars labeled SUV 1 SUV 2 SUV 32 The symbol must immediately follow the user SVAR label All text following the symbol including other global or local vars and blanks will become the current value of the target user Svar preceding the symbol Proprietary Product of NETEC International Inc Copyright 2004 Page 81 Logical Console Operator User Manual 11 12 05 PRIME Command The text is any string of characters including the WILDCARD This statement specifies that LOCO is to determine the reply already issued WTOR text at the time of LOCO startup or at the time of a LOAD command and place the reply number in the the user s reply VAR as specified by the SET command The PRIME statement is used in conjunction with the WTOR SET operand to insure that WTORs issued before LOCO number for the outstanding startup are maintained consistently with WTORs issued after LOCO Startup See SPECIAL TECHN
130. TN IGDSSIIN INITPARM ID 00 PROMPT DISPLAY SUBSYS SUBNAME JES2 PRIMARY YES START NO SUBSYS SUBNAME R SUBSYS SUBNAME TNF SUBSYS SUBNAME LOGR INITRIN IXGSSINT SUBSYS SUBNAME RRS SUBSYS SUBNAME CICS SUBSYS SUBNAME IRLM SUBSYS SUBNAME JRLM The following is an example of an IEFSSNxx member after the addition of the LOCO subsystem definition for a ACF INITRTN IRRSSIOO INITPARM subsystem named LOCO SUBSYS SUBNAME SMS INITRTN IGDSSIIN INITPARM ID 00 PROMPT DISPLAY SUBSYS SUBNAME JES2 PRIMARY YES START NO SUBSYS SUBNAME R SUBSYS SUBNAME TNF SUBSYS SUBNAME LOGR INITRTN IXGSSINT SUBSYS SUBNAME RRS SUBSYS SUBNAME CICS SUBSYS SUBNAME IRLM SUBSYS SUBNAME JRLM SUBSYS SUBNAME LOCO INITRTN LOCOINIT INITPARM 252 Addition Either an IPL or a dynamic MVS console is required to new subsystem name LOCO may be installed before or subsystem addition via the inform the MVS system of the after the IPL but LOCOMAIN will execute only after the subsystem has been defined link list when the SETSSI be available via the MVS The LOCOINIT program must command or IPL is perform or LOCO will not initialize To dynamically add the LOCO subsystem enter th following command from an MVS console Ihe INITPARM Proprietary Product of N
131. The LOCO import export utility has found both the TABLEDD and TABLEDSN keywords on an EXPORT control statement and one Correct execution TABLEDD M SS NG FROM THE JCL The user has specified th EXPORT control card and the the job the TABLEDD keyword is not These keywords are mutually exclusive must be removed the error and submit the job for TABLEDD key word on an DDNAME specified in found in the JCL for Correct the error and submit the job for execution THE MEMBER KEYWORD IS REQUIRED The member keyword is required on the LOCO import export utility EXPORT control card Correct the error and submit the job for execution THE MEMBER CAN NOT BE FOUND The member specified in the MEMBER keyword of the LOCO import export utilit not found ty EXPORT control card is Correct the error and submit the job for execution THE OUTDSN CAN NOT BE FOUND The user has specified the OUTDSN key word on an EXPORT control card and the data set name specified in the OUTDSN keyword is not be found Correct the error and submit the job for execution THE TABLEDSN CAN NOT BE FOUN The user has specified th D TABLEDSN key word on an EXPORT control card and the data set name specified in the TABLE DSN keyword is not be found
132. The valid actions that can be specified for a queue entry are Action Description H Hold the time queu ntry Prevent LOCO from taking action should actions required to execute this queue entry be meet Proprietary Product of NETEC International Inc Copyright 2004 Page 130 Logical Console Operator User Manual 11 12 05 R Rel action should ent as ry be D Delete this the time queu ntry Release LOCO to take actions required to execute this queue meet entry from the tim time queue entry LOCO will remove the Security Requirements queue To replace th ntry in the queue will require the LOCO table be reloaded To manipulate these resources requires READ access to the following SAF Profiles LOCO Xxxxx SSI LOCO xxxx QUEUES T LOCO xxxx QUEUES Tl LOCO xxxx QUEUES TIME DELETE XXXX To manipulate following SAF LOCO XXXX LOCO XXXX LOCO XXXX LOCO XXXX XXXX E Copyright 2004 ME BROWSE ME HOLD The thes Prof SSI one to four to access the LOCO subsystem to display queue entries to HOLD RELEASE queue entries to DELETE queue entries character LOCO subsytem name e resources iles SUBM I BROWSE SUBM DEDI SUBM I SUBMIT The one to four requires READ access to the EO TO O TO ac
133. User Manual 11 12 05 Setting Operational Parameters One of the first tasks a new user of the LOCO TSO interface must do is to set the default operation parameters The session parameters will be retained across TSO sessions This is done by entering option 0 in the main selection menu and pressing the ENTER key The following screen will be displayed I CDDF5100_MANUAL EXTRA Personal Client E 18 x File Edit View Tools Session Options Help e Logical Console Operator TSO Operator Interface Default Settings Command Loco Subsystem Name gt LOCA Specify Loco Subsystem Name Log Commands gt Y Y N Create log of commands Log Responses gt Y Y N Create log of responses Trace TSO Activity gt Y Y N Activate TSO internal trace Unit Type gt SYSDA Temp Dataset Unit Name Volume Name Temp Dataset Volume name Allocation Unit gt CYL Temp Dataset Allocation Unit TRK CYL or BLK Primary Quantity gt 100 Primary Allocation Quantity Secondary Quantity gt 10 Secondary Al location Quantity A licensed proprietary product of NETEC International Copyright 2002 00 1 05 34 This screen is used to specify the various options that are to be used when executing the LOCO TSO interface The parameter descriptions follow Loco Subsystem Name This is the one to four character name of the LOCO subsystem that the user wishes to control Log Commands T
134. able to access any LOCO TSO interface connecting to any LOCO subsystem Specific profile that will match users who are trying to access the LOCO subsystem named LOCA Users permitted with READ access to this profile will be able to access the LOCO TSO interface connecting to LOCO subsystem LOCA Proprietary Product of NETEC International Inc Copyright 2004 Page 144 Logical Console Operator User Manual 11 12 05 The RACF commands necessary to define these profiles are RDEFINE FACILITY LOCO SSI UACC NONE RDEFINE FACILITy LOCO LOCA SSI UACC NONE Permission to access LOCO status screen LOCO ssss STATUS Ssss Subsystem Name Example LOCO STATUS Generic profile that will match any request to access the STATUS display for any LOCO subsystem Users permitted with READ access to this profile will be able to access the status screen for any LOCO TSO interface connecting to any LOCO subsystem LOCO LOCA STATUS Specific profile that will match users who are trying to access the status Screen for the LOCO subsystem named LOCA Users permitted with READ access to this profile will be able to access Status screen for LOCO subsystem LOCA The RACF commands necessary to define these profiles are RDEFINE FACILITY LOCO STATUS UACC NONE RDEFINE FACILITy LOCO LOCA STATUS UACC NONE P
135. al message indicating the option is active on a LOCO BUI LD import expor LOCOB None LOCO TABLE BUI SUCCESSFUL UNSUCCESSFUL FOR MEMBER mmmmmmmm XX This success or failure of the LOCOBLI LOCOB YES LDR ha t utility s been invoked to build the member mmmmmmmm is an LDR pr LD PROCESS WAS informational ograms return None MEMBER mmmmmmmm NOT ADD IMPORT command and the table for SUCCESSFUL UNSUCCESSFUL RG message indicating the code is XX DR process The 1 D REPLACED BECAUSE OF PREVIOUS ERROR There has been a previous error that has prevented the adding or replacing of Correct the error and submit execu LOCO tion the member mmmmmmmm t the job for IABLE IMPORT EXPORT PREVI This LOCO error OUS ER is an RORS informational UTII IY STOPPED DUE TO message indicating the import export utility has terminated due to S Correct the error and submit the job for execu LOCO COMPL This tion TABLE ETE RC is inf IMPORT EXPORT XX ormational UTII IY EXECUT ON message indicating that this execution of the LOCO import export utility is complete with the highest return code encountered XX None Proprietary Product of NETEC International Inc
136. an the WAITIME operand serv ntirely different functions in LOCO When all the requested ACTIONs of an LOCO table statement have been executed LOCO recycles the statement to wait for its originating event WTO or WTOR text If SLEEP is coded on that statement then LOCO deactivates the statement for the duration of the SLEEP interval before recycling it Thus the table statement disappears for that period of time The WAITIME operand causes a time delay within a sequence of LOCO ACTIONs Its purpose is to allow one ACTION to get started or perhaps to complete before starting the next ACTION It is important to understand that once an LOCO table statement is triggered it must complete all the requested ACTIONs and be recycled before it can be triggered again If that statement is SLEEPing or WAITingTIME when the next trigger event occurs the trigger event will be lost Grouping related events When events are interrelated by time interval it is best to keep all the ACTIONs in a single LOCO table statement when possible Suppose you want to start up a data collection task like GTF trace at a certain time terminate it at a certain time and then run some follow up task to print the results One way to do this is 16 00 ACTION S GTF FRANK WTOR AHL125A REPLY
137. ange the control at any time the TSO ISPF interface perhaps for different You may manually or table s The following is a sample LOCO control table compiled by LOCOBLDR to check the syntax and to produce an work currently in use The table would be DEFINE WILDCARD PREFIX Q STARTUP ACTION S TSO WTO IEE362A ACTION S SMFDUMP SLEEP 30 00 WTOR IEF238D REPLY CANCEL 08 15 00 ACTION gt LOGRECA WAITIME 02 00 ACTION gt LOGRECB COMMAND D ACTION D U 1 e The DEF INE car character to be used for this for LOCO contr console comman e The STARTUP ca only when LOCO d tells LOCO that an table The ra optimized object table suitable for processing by LOCOMAIN is the wildcard is the prefix ol commands and for site developed custom ds rd tells LOCO to issue the MVS command is first initialized e The WTO card i nstructs LOCO to upon the occurrence of a WTO wi ticular table entry to SLEEP for thirt 1 issue S SMFDUMP of IEE362A and 2 put this par minutes i e ignore subsequent next thirty minutes e The WTOR card passing throug IEF238D Wh never thes issue the MVS command REPLY xx CANCEL appropriate reply number e The card instructs LOCO to 1 wait unti
138. antity of the allocation unit to be used when dynamically allocating the LOCO table compilation output data set Proprietary Product of NETEC International Inc Copyright 2004 Page 109 Logical Console Operator User Manual 11 12 05 Displaying LOCO Status Entering option 1 on the main selection menu and pressing the ENTER key displays the current status of the LOCO system The following screen will be displayed J CDDF5100_MANUAL EXTRA Personal Client laj xl File Edit View Tools Session Options Help meeen Logical Console Operator TSO Operator Interface Status Display for LOCA Command gt _ LOCO Version Information gt 3 3 08 31 02 15 06 LOCO Table Dataset gt NETEC LOCO33 TABLES Active Table gt CAFCTABL 2002 243 15 39 06 LOCO Submit Dataset gt NETEC LOCO33 JCLLIB Action Status WTO gt Active WTOR gt Active TIME gt Active EVENTS gt Active Slots Used gt 19 Total Slots gt 200 Total Msgs Lost gt The last activity was at 7 54 55 K A NONE L 1 Message Counts WTO gt 370 WIOR gt 0 Commands gt Actions gt 2 Replies gt 0 ABENDS gt Re issued NTOs gt Trace Status Master Trace gt On Trace all WQE OREs gt Off Trace CICS activity gt Off Trace all messages gt Off B 00 4 03 15 This is the status screen for the selected LOCO subsystem This Scree
139. ars Proprietary Product of NETEC International Inc Pag labeled SUV 1 e71 Logical Console Operator User Manual Copyright 2004 11 12 05 SUV 2 SUV 32 The symbol must immediately follow the user SVAR label All text following the symbol including other global or local vars and blanks will become the current value of the target user Svar preceding the symbol Proprietary Product of NETEC International Inc Page 72 Logical Console Operator User Manual 11 12 05 WTOR Statement The text is any string of characters including the WILDCARD This statement delineates a reply and possibly an action or series of actions to be performed by LOCO whenever a WTOR is issued through the MVS system matching the coded text LOCO produces a confirmation message whenever it responds to a WTOR REPLY The text is any st Svars for real global text REPLY text REROUTE routes ACTION text LOTIME time HITIME time DATE date LODATE date HIDATE date WEEKDAY mtwtfss JOBNAME value JOBTYPE value CPUID cccc TSOID ttttttt ORIGIN value WAITIME time WAITEXT tex RESET time SET SUV nn t SET SR or local REPLY is issued If the REPLY requir option option option option option option option option option option option option opt
140. ary administrator functions 9 IBM Products IBM program development products 10 SCLM SW Configuration Library Manager 11 Workplace ISPF Object Action Workplace L Loco Logical Console Operator Interface Addition INIT PROC IF amp ZCSTF 1 ATTR GRPBOX1 WIDTH 0 IF CURSOR TMPROWS AND amp ZCMD amp ZSAR TRANS amp ZSCREEN 1 amp ZSAREA1 2 amp ZSAREA2 3 amp ZSAREA3 4 amp ZSAREA4 IF amp ZSAR CAL UPS SES amp ZCMD SP amp ZSEL TRANS TRUNC amp ZCMD 0 PGM ISPISM SCRNAME SETTINGS 1 PGM ISRBRO PARM ISRBROO1 SCRNAME VIEW Proprietary Product of NETEC International Inc Copyright 2004 Page 30 Logical Console Operator User Manual 11 12 05 2 PGM ISREDIT PARM P ISREDMO1 SCRNAME EDIT 3 PANEL ISRUTIL SCRNAME UTIL 4 PANEL ISRFPA SCRNAME FOREGRND 5 PGM ISRJB1 PARM ISRJPA SCRNAME BATCH NOCHECK 6 PGM ISRPTC SCRNAME CMD 7 PGM ISPYXDR PARM amp ZTAPPLID SCRNAME DTEST NOCHECK 8 PANEL ISRLPRIM SCRNAME LMF 9 PANEL ISRDIIS ADDPOP 10 PGM ISRSCLM SCRNAME SCLM NOCHECK 11 PGM ISRUDA PARM ISRWORK SCRNAME WORK L PANEL LOCOTSM1 NEWAPPL LOCO PASSLIB Addition X EXIT SP PGM ISPSAM PARM PNS Ny ter y amp ZTRAIL TRAIL PNTS END c Modify t
141. as a WTO through the MVS system After the text is seen as a WTO the next ACTION is performed Note Both WAITIME and WAITEXT may be coded between ACTIONS In that case the second ACTION will be performed as soon as EITHER wait condition is satisfied The wait keywords are functionally connected by a logical OR operator Proprietary Product of NETEC International Inc Page 75 Logical Console Operator User Manual 11 12 05 RESET The time is of the format HH MM SS and represents an amount of time not a clock value A RESET may be coded only after a WAITEXT and specifies an amount of time after which LOCO is to automatically terminate the WAITEXT and recycle the LOCO table entry without executing any of the following ACTIONs The table entry will then wait for the next occurrence of the original WTOR text SET SET is an ACTION keyword used to insert values into user SVARS There are 32 user Svars labeled SUV 1 SUV 2 SUV 32 The symbol must immediately follow the user SVAR label All text following the symbol including other global or local vars and blanks will become the current value of the target user Svar preceding the symbol SET is also used to automatically save and update the WTOR reply number in a reply SVAR There are 16 reply vars labeled SRf1 SR 16 In th
142. atement 24 ct c0 cies 6 08 bows oh ee ees Otani ecules 83 CAF CCMD Statement es at Eee ooo Deel ee eee a ee ee 86 DBCICMD Stdtelniertu severe a a de OE Sie eis ok Ria wie wie e Da wie sles 91 Compressing LOCO Table and Submit Libraries 93 Pseudo WEIO cEaGQ lity sea yk eed ise Sede ee a era Seed Se he eed pru epis 94 Inserting LOCO Psuedo WTOs in Batch Job Streams 95 Creating Custom LOCO Actions via User Exit Programs 96 Operations GUILE 6 we bake Ged oa Ge eet bake eine Aten a eee ee ad 97 Operacional Comanda rers ewe ese eee ee xS eee eee bee Oe aos Seale 97 CHELE Command i deno ie Sura aderat oat indie lan eared a el ide ded aan eat ln dears 98 gt Commands siaa a Seas ea we RUE wees EUR ah ee Soe eee oo See eee eae 98 a STOP Commeatid i2 4 5 a iet oe cae per eei IE RU T Qn erri ie coe Bie vee a ae be ees 98 QSTATUS Comm nd gsicek ecetewe ay mtt ed mE we eee we cr e eR ELT T S 99 Proprietary Product of NETEC International Inc Copyright 2004 Page 3 Logical Console Operator User Manual TO AD Command 229 eene ee e ee ee hia ee a ee hike Boe Se eee ee GDEACTIVATE Command sentem ee ge Gi Aw Soe ala ee eal QACTIVATE COmmalna oic arepe ee pa een ise eee Bad Ee LE IR ae ees ee G HOLD COMMANG aeree Mie eee x amu ee ee es ORO eet QW SER eee RUE RELEASE Command serso eo wee Ide RU REIS TUE YU esters Sd Sos Seats Oe es CRESET Command ston ode Gacr et er eatnre tet Gio ree ound Saad uer
143. ating LOCO If no operand is specified then all user exit programs will be reloaded COMMAND OPERANDS Proprietary Product of NETEC International Inc Copyright 2004 Page 105 Logical Console Operator User Manual 11 12 05 TSO Users Guide A new feature in LOCO 3 3 is the ability to maintain and control LOC from a TSO interface ANY TSO user that is LOGONed to the same MVS image where LOCO is executing and has sufficient security authorization may interactively maintain LOCO tables and control LOCO functions The LOCO TSO interface is implemented as an ISPF application The following screen should look something like your primary ISPF options screen In this example the user would select option L to invoke the LOCO TSO interface J CDDF5100_MANUAL EXTRA Personal Client i E la x File Edit View Tools Session Options Help Menu Utilities Compilers Options Status Help ISPF Primary Option Menu Option gt _ Settings Terminal and user parameters User ID U2TEC8 Vieu Display source data or listings Time 12 05 2 Edit Create or change source data Terminal 3278 3 Utilities Perform utility functions Screen 1 4 Foreground Interactive language processing Language ENGLISH 5 Batch Submit job for language processing Appl ID ISR 6 Command Enter TSO or Workstation commands TSO logon NTECTEST 7 Dialog Test Perform dialog testing TSO prefix U2TEC8 8 SDSF Spool Display
144. ating jobs submitted by that TSO user The TSOID value may contain wildcard characters The filter condition may be reversed by preceding the TSO id value by the symbol E G TSOID PC1 The date must follow the exact format of MM DD YY or MM DD YYYY It is a filter keyword ENDOFSTEP actions will only be performed on that particular date The date must follow the exact format of MM DD YY or MM DD YYYY It is a filter keyword ENDOFSTEP actions will only be performed on or after that particular date The date must follow the exact format of MM DD YY or MM DD YYYY It is a filter keyword ENDOFSTEP actions will only be performed on or before that particular date Note HIDATE and LODATE may be specified together but DATE may not be specified with either of them If any of the above date operands is specified as MM DD YY LOCO will provide the complete YYYY internally If YY is in the range of 00 through 50 then the century will be set to 20 if YY is higher than 50 then the century will be set to 19 The string of characters represents the seven days of the week beginning with Monday It is a filter keyword The ENDOFSTEP actions will NOT be performed on weekday positions which contain a period Example WEEKDAY M F would cause the ENDOFSTEP actions to be performed on Monday and Friday only
145. be requires LOCO TSO The at any time use of generic Second the d function within the the requested function as simple or as security function is described as part of that function s description found in the TSO Users Guide sect Guide in the Security for the TSO tion of this manual define resource profiles can also be found in Interface section Details on how to the TSO Users Security profiles must be defined before any user can access the LOCO TSO Interface Proprietary Product of NETEC International Inc Copyright 2004 Page 32 Logical Console Operator User Manual 11 12 05 Step 8 Print and review the sample LOCO control tables from the The following JCL is member STEP6JCL Copyright 2004 LOCO source P in your source pds DS examples your ins These tables can be used as when preparing LOCO control tables for use in tallation LOCOPRNT JO PROC PRINT GENER SYSPRI SYSUT2 SYSUT1 SYSIN SAMP1 SAMP2 SAMP3 SAMP4 SAMP5 SAMP6 SAMP7 SAMP8 SAMP9 SAMP10 NT DD DD DD DD EXE S TEE E j pj E MxM MK MX ATSA AQA EMB ER DISP SHR
146. be enclosed in parentheses immediately following the Example ACTION G R7 R3 D5 message ACTION R2 D2 non deletable message Proprietary Product of NETEC International Inc Copyright 2004 Page 102 Logical Console Operator User Manual 11 12 05 If no routing or descriptor codes are specified for the command then R2 D7 is used as an initial default This default may be changed by the ROUTE operand on the DEFINE statement Command The SEND command may not be keyed on the MVS console It is for use as an ACTION in an LOCO control table It may be used to send a message to a specific TSO user or to the implied owner of an executing job COMMAND OPERANDS The second format allows an explicit destination for the message text to be specified as TSO user id ttttttt In the first format the dest ination is implied defaulted to as the value of the variable STSOID Command The PRINT command may not be keyed on the MVS console It is for use as an ACTION in an LOCO control table It may be used to print a message to the SYSPRINT data set COMMAND OPERANDS Proprietary Product of NETEC International Inc Copyright 2004 Page 103 Logical Console Operator User Manual 11 12 05 Command The CRITICAL command is for use as an ACTION in an LOCO control table It may be used to
147. bles and their respective values are established by the SET operand in STARTUP WTO WTOR COMMAND or time statements Proprietary Product of NETEC International Inc Page 53 Logical Console Operator User Manual 11 12 05 SR 1 SR 16 These 16 specific user variables automatically retain and update WTOR reply numbers for deferred replys Their values are established by the SET operand in the WTOR or PRIME statements STEXT This character string is set to the WTO WTOR or COMMAND text which triggered the ACTION By using several STEXT substrings in the ACTION value it is possible to substitute any combination of originating text into the ACTION text Notice that whenever a series of ACTIONSs is interrupted by a WAITEXT the value of STEXT is reset to that of the most current WTO which triggers the WAITEXT condition SMINOR This character string is set to the MINOR line text of the WTOwhich triggered the ACTION SJOBNAME This value is set to the JCL jobname of the job task or TSO user which issued the triggering activity SSTEPNAME This value is set to the JCL stepname of the job task or TSO user which is
148. cal Console Operator User Manual 11 12 05 Rel ac ent Del ry be meet eni try from the COMMAND queue the queue will Execute this COMMAN lease the COMMAND queue entry tion should a Re ctions required to execute lete this COMMAND q req lease LOCO to take this queue ueue entry LOCO will remove the To replace th ntry in uire the LOCO table be reloaded D queue entry LOCO will execute th command as it had been entered via the MVS console Security Requirements To manipulate these resources following LOCO LOCO LOCO LOCO LOCO XXXX Copyright 2004 SAF Profiles XXXX XXXX XXXX XXXX XXXX SSI QUEUES QUEUES COM COM QUEUES QUEUES COM COM The one to MANI MANI MANI MANI fo requires READ ac to acc subsys D BROWSE x D HOLD to HOL entrie D DELETE to D EXECUTE to EXE r character cess to the ess the LOCO tem to display queue entries D RELEASE queue S DELETE queue entries CUTE command queue LOCO subsytem name Proprietary Product of NETEC International Inc Page 143 Logical Console Operator User Manual 11 12 05 Security for the LOCO TSO Interface The LOCO TSO interface utilizes an ext ternal security manager such as RACF ACF2 or Top Secret to verify a user s functional aut
149. cated in the LOCO submit library member list as illustrated below 18 xl 3 CDDF5100_MANUAL EXTRA Personal Client File Edit View Tools Session Options Help LOCO SUBMIT DSNAME NETEC LOCO33 JCLLIB Row 00001 of 00019 Command gt _ Scroll gt PAGE Name Prompt Size Created Changed ID ASMLOCO 97 2000 07 17 2002 08 10 12 03 08 U2TEC8 ASM2016 60 2001 11 15 2002 02 16 13 42 58 U2TEC8 IEFBRI4 SUBMIT 2002 07 13 2002 08 07 18 17 48 U2TEC8 LOCB 25 2000 07 22 2002 08 25 10 47 23 U2TEC8 MANYWTOS 3 2002 04 13 2002 04 13 09 24 55 U 2TEC8 TASM 197 2002 03 29 2002 03 29 13 42 18 U2TEC8 TBLDR 25 2000 07 22 2001 09 29 10 50 15 UZTEC8 TCMD 2001 09 03 2002 07 06 17 59 44 U2TEC8 TDUMP 6 2002 03 29 2002 03 29 12 54 03 UZTEC8 TIGNT 11 2002 03 29 2002 03 29 11 23 38 X U2TEC8 TINIT 11 2000 07 22 2002 07 13 15 42 13 U2TEC8 TINTF 13 2001 09 01 2001 09 01 17 26 30 U2TEC8 TLOG 34 2001 09 03 2001 09 03 10 02 12 U2TEC8 TREPT 13 2001 07 03 2002 03 28 10 03 59 UZTEC8 TSIMUL8 23 2002 03 29 2002 03 29 16 24 09 U2TEC8 TTEST 6 2000 07 22 2001 09 01 08 20 15 UZTEC8 TWQE 23 2002 07 13 2002 07 13 14 55 11 U2TEC8 IWTO 5 2002 03 29 2002 03 29 14 16 03 U2TEC8 ZAP 12 2001 09 03 2001 09 03 11 20 23 U2TEC8 xXEndx 1 00 1 02 15 Connected to host 10 1 1 20 den 11 53 AM Proprietary Product of NETEC International Inc Copyright 2004 Page 127 Logical Console Operator User Manual 11 12 05 Displaying and Manipulating
150. cess the LOCO subsystem display the queu ntries edit the submit data set request LOCO submit the job character LOCO subsytem name Proprietary Product of NETEC International Inc Page 131 Logical Console Operator User Manual 11 12 05 Displaying and Manipulating the WTO Queue The following screen is displayed when the user selects the WTO queue for manipulation la x d CDDF5100 MANUAL EXTRA Personal Client File Edit View Tools Session Options Help See Logical Console Operator TS0 Operator Interface Display Manipulate WTO Queue for LOCA Command gt _ Scroll gt CSR _ WT0 ZZZ0099E THRESHOLD 9 UNTIL 24 00 00 LOTIME 8 00 00 HITIME 17 00 20 LODATE 2002 085 HIDATE 2002 091 WEEKDAY MTWT SS JOBTYPE JOB JOBNAME MYJOB4 TSOID UZTEC8 CPUID NTC1 ORIGIN ORGA MINOR MINOR TEXT ACTION K E D L 01 WAITIME O0 01 00 ACTION K A NONE L 1 WAITEXT WAITTEXT RESET 02 00 00 ACTION K A NONE L 2 SET UV 4 VARIABLE4 _ WTO LDD Z99E UNTIL 24 00 00 HITIME 24 00 00 WEEKDAY MTWTFSS ACTION D R L _ NTOCXXXDUO9E THRESHOLD 9 UNTIL 24 00 00 LOTIME 8 00 0 HITIME 17 00 20 LODATE 2002 085 HIDATE 2002 091 WEEKDAY MTWT SS JOBTYPE JOB JOBNAME MYJOB TSOID UZTEC8 CPUID NTC1 ORIGIN ORG3 REROUTE D3 R 6 00 1 03 15 Connected to host 10 1 1 20 Jie 11 13AM From this screen the user can delete hold or release a specific entry on the LOCO WT
151. critical file2 DISP SHR DCB BUFNO 1 CRITCAL3 DD DSN your loco critical file3 DISP SHR DCB BUFNO 1 INTRDR DD SYSOUT A INTRDR DCB BLKSIZE 80 SYSPRINT DD SYSOUT SIMULATE DD SYSOUT REPORT DD SYSOUT SYSABEND DD SYSOUT ALOGSUBT DD SYSOUT CAFCSUBT DD SYSOUT DBCTSUBT DD SYSOUT LOCOALOG DD SYSOUT Copyright 2004 Proprietary Product of NETEC International Inc Page 42 Logical Console Operator User Manual 11 12 05 Starting the LOCO Subsystem This is COMMANDS dictated utilize the main LOCO job table DBCTCMD commands or It interrogates WTOs coming from the MVS system and performs actions as by the current control the CAFCCMD must be added to the LOCOMAIN step that WTORs and If the user is going to in a LOCO table contain the STEPLI Bs DSNAMEs of the CICS Application File Control system and the DBControl Batch Interface PROCOMAIN GOB uuscax e Ute val LOCO EXEC PGM LOCOMAIN DPRTY 15 15 PERFORM 9 TIME 1440 Hl REGION 1024K PARM MEMBER tabname SSN xxxx o
152. d be verified in the Initialization and Tuning Guide for the MVS version that is executing in your installation LNKLST DEFINE NAME LNKLSTOO NKLST ADD NAME LNKLST00 DSN SYS1 SERBLINK NKLST ADD NAME LNKLST00 DSN NETV130 SCNMLNK1 VOLUME Z1RES2 INKLST ADD NAME LNKLSTOO DSN NETV130 SEKGMOD1 VOLUME Z1RES2 INKLST ADD NAME LNKLSTOO DSN NETV130 SEKGMOD2 VOLUME Z1RES2 LNKLST ADD NAME LNKLSTOO DSN IGY210 SIGYCOMP VOLUME Z1RES2 NKLST ADD NAME LNKLSTOO DSN FAN130 SEAGALT VOLUME Z1RES2 NKLST ACTIVATE NAME LNKLSTOO The following example is a partial listing of the same PROGxx member with the LOCO library added NKLST DEFINE NAME LNKLSTOO LNKLST ADD NAME LNKLST00 DSN SYS1 SERBLINK LNKLST ADD NAME LNKLSTO0 DSN NETV130 SCNMLNK1 VOLUME Z1RES2 NKLST ADD NAME LNKLSTOO DSN NETV130 SEKGMOD1 VOLUME Z1RES2 INKLST ADD NAME LNKLSTOO DSN NETV130 SEKGMOD2 VOLUME Z1RES2 INKLST ADD NAME LNKLSTOO DSN IGY210 SIGYCOMP VOLUME Z1RES2 NKLST ADD NAME LNKLSTOO DSN FAN130 SEAGALT VOLUME Z1RES2 LNKLST ADD NAME LNKLSTO0 DSN your load pds Addition LNKLST ACTIVATE NAME LNKLSTOO Proprietary Product of NETEC International Inc Copyright 2004 Page 19 Logical Console Operator User Manual 11 12 05 To authorize the LOCO library usually found in must be modified tial listing of the program list SYS1 PARMLI shows a par B member befo
153. der important it precisely follows your instructions LOCO s accuracy and reliability ultimately benefit your information center s end users Improved on line response increased batch throughput and 24 X 7 uptime are all realistic goals LOCO supports your operations staff with job scheduling and automatic response to WTO R s It supports your network controllers by monitoring and restarting VTAM lines and devices and by automating NCCF commands and responses It supports development staffs by translating cryptic error messages and by routing explanatory messages to TSO users It supports technical support teams by restarting failed software components like CICS or IMS regions LOCO routes concise messages to specific consoles and TSOids with responsibility lists and suggested corrective actions LOCO s role in the data center is often determined by the Operations staff the system programming staff and the network control group Together they determine which system and application activities will be monitored and controlled by LOCO These automatic activities include 1 console actions triggered by WTOs 2 console actions triggered by WTORs 3 TIME initiated actions and 4 actions triggered by the execution of additional job steps which post messages directly to LOCO In the course of managing resources LOCO will submit job streams perform complex sequences of actions specif
154. e LCON0610 Explanation User Response LCONO611 Explanation User Response LCON0612 Explanation User Response Copyright 2004 may have terminated Contact NETEC Technical Support at your earliest conve SAQ E LOCOI the S nience RROR ting LOCO N NTF tain CSA storage for a why CSA storage was not available LOCOMAI N NTF attempted to delete a LOCOSA pointer from AQ but could not find the proper slot Contact NETEC Technical Support at your earliest conve nience NOT A LOCOI was a autho See t USERS UTHORI ED n rization he LCON NTF found that i installa t was not APF authorized SVC number provided to obtain APF GUI nor tion procedure in the LCON DE for a complete discussion of methods of providing APF authorization to LCON BOX QUEUE FULL In attempting to pass a pseudo WTO to LOCOMAIN LOCOINTF found that the queue was full This can happen when LOCOMAIN has a relatively low dispatching priority Increase the dispatching priority of LOCOMAIN Proprietary Product of NETEC International Inc Page 185 Logical Console Operator User Manual 11 12 05 Messages from LOCO Subtask LCONO700 Explanation Issued by User Response LCONO701 Explanation Issued by User Response LCONO703 Explanation Issued by
155. e OUTDD or OUTDSN key word has found otherwise Correct the error and submit the job for execution NEW MEMBER NAME NOT ALLOWED WHEN GENER NAME SPECIFIED The MEMBER KEYWORD of a LOCO EXPORT contains a generic member name The new member name has been specified The new member name cannot be specified when the member name is generic Correct the error and submit the job for execution C MEMBER EXPECTED CONTINUATION NOT RECEIVED While processing a LOCO import export control card an expected continuation was not received Correct the error and submit the job for execution Proprietary Product of NETEC International Inc Page 201 Logical Console Operator User Manual 11 12 05 LCONO0941E Explanation User Response LCON0942I Explanation User Response LCON0943E Explanation User Response LCON0 944E Explanation User Response LCON0945E Explanation User Response LCON0946E Explanation User Response LCON0 947E Explanation User Response Copyright 2004 LOCO TABLE IMPORT EXPORT UT ALLOCATION ERROR ALLOCATE DEALLOCAT TY DYNAMI Ea MEMBER mmmmmmmm RC rrrrrrrr E The LOCO import export utility has encountered a dynamic allocation error attempting to allocate or deallocate the ds
156. e century will be set to 20 if YY is higher than 50 then the century will be set to 19 The string of characters represents the seven days of the week beginning with Monday It is a filter keyword The WTO actions will NOT be performed on weekday positions which contain a period Example WEEKDAY SS would cause the WTO actions to be performed on Saturday and Sunday only JOBNAME Copyright 2004 Ihe value must follow the MVS JCL requirements for jobnames It is a filter keyword WTO actions will be performed only for MVS jobs with matching jobnames which issue the WTO text The JOBNAME value may contain WILDCARD characters The ACTION text may Proprietary Product of NETEC International Inc Page 65 Logical Console Operator User Manual 11 12 05 contain global or local vars for real time substitution The filter condition may be reversed by preceding the jobname value by the minus symbol E G JOBNAME FREDSJOB JOBTYPE CPUID TSOID ORIGIN THRESHOLI SLEEP Copyright 2004 BS The jobtype must be one of the following strings STC JOB TSU MSTR JES2 JES3 It is a filter keyword WTO actions will only be performed for WTOS issued by subsystem MSTR JES2 JES3 or type of job STC JOB TSU The filter condition may be reversed by preceding the jobtype value by the minus symbol E G JOBTYPE STC The
157. e equivalent of coding a N in column 71 of a CAFC control card For a complete description of executing CICS transactions through the CAFC LUO interface see the CICS Application File Control Facility Installation Manual This field contains the CICS applid and the CAFC control file dataset name that the CAFC commands found in the ACTION key words are to be executed against The applid is the 1 to 8 character VTAM application identifier of the target CICS system The cntl file name is the fully qualified data set name of the CAFC control file of the target CICS system The CTLFILE keyword can be repeated as many times as necessary This field contains the CAFC command that is to be issued against the CICS system defined in the previous Proprietary Product of NETEC International Inc Page 89 Logical Console Operator User Manual 11 12 05 Copyright 2004 CTLFI LE field The CAFC command formats can be found in the CAFC Users manual repeated as many times as necessary Note The ACTION keyword can be ACTIONS are applied to the CICS system described by the preceding CTLFILE keyword By coding a sequence of CTLFILE keywords followed by ACTION keywords multiple CAFC commands can be issued against multiple CICS regions as part of the same CAFCCMD defined command The following example will cause the DDNAMEO1 and and
158. e following screen is displayed when the user selects the WTOR queue for manipulation J CDDF5100_MANUAL EXTRA Personal Client E lel x File Edit View Tools Session Options Help EA Logical Console Operator TSO Operator Interface Display Manipulate WTOR Queue for LOCA Command gt _ Scroll gt CSR _ NTORCLDDROS9E UNTIL 24 00 00 HITIME 24 00 00 WEEKDAY MTWTFSS REPLY R XXXX YES _ NTOR HTOROSOE THRESHOLD 9 UNTIL 24 00 00 LOTIME 08 00 00 HITIMECI7 00 00 LODATE 2002 085 HIDATE 2002 091 WEEKDAY MTWT SS JOBTYPE JOB JOBNAME MYJOB TSOID UZTEC8 CPUID NTC1 ORIGIN ORG3 REROUTE D3 R7 REPLY R XXXX YES ACTION K E D L 1 WAITIME 00 01 00 ACTION K A NONE L 1 WAITEXT WAITTEXT RESET 2 80 80 ACTION K A NONE L 2 SET R 1 SET SUV 5 VARIABLES neaaacegeaoeeepedepepgedeeeedee END OF QUEUE XXXXXXXXRRXRRRKRHRRRRKRRRRRER 6 00 1 03 15 Connected to host 10 1 1 20 il 11 13 AM From this screen the user can delete hold or release a specific entry on the LOCO WTOR queue Each queue entry is formatted on multiple lines Before the beginning of a queue entry is an action field where the user specifies what action he would like LOCO to take against the following WTOR queue entry The valid actions that can be specified for a queue entry are Action Description H Hold the WTOR queue entry Prevent LOCO from taking action should actions
159. e operands is specified as MM DD YY LOCO will provide the complete YYYY internally If YY is in the range of 00 through 50 then the century will be set to 20 if YY is higher than 50 then the century will be set to 19 ing of characters represents the seven days of k beginning with Monday It is a filter SHUTDOWN actions will NOT be performed on positions which contain the character WEEKDAY M W F would cause the SHUTDOWN actions only Note WAITIME WAITEXT Copyright 2004 Ihe tim amount coded a time be to be performed on Monday Wednesday and Friday Whenever multiple filter keywords are coded all criteria must be satisfied in order for the actions to be performed The filter keywords are functionally connected by a logical AND operator e is of the format HH MM SS and represents an of time not a clock value A WAITIME may be fter an ACTION causing a wait for that amount of fore proceeding to the next ACTION The tex WILDCAR causing WTO thr a WTO Note t is any string of characters including the D A WAITEXT may be coded after an ACTION a wait until that text string is issued as a ough the MVS system After the text is seen as the next ACTION is performed Both WAITIME and WAITEXT may be coded between ACTIONS If both are coded the second ACTION will be performed as soon as EITHER wait
160. e return codes from the CAFC batch interface should be accumulated or ignored The position of this operand in the CAFCCMD statement determines if it is the default or to be applied to a specific CAFC ACTION If the RC operand is found in the CAFCCMD before any ACTION keywords the RC is specifying the default for all CAFC ACTIONS found in the CAFCCMD If the RC operand follows an ACTION it applies only to that CAFC ACTION Coding RC ACCUM is the equivalent of coding a A in column 72 of a CAFC control card and coding RC IGNORE is the equivalent of coding a I in column 72 of a CAFC control card For a complete description of ignoring and accumulating return codes see the CICS Application File Control Facility Installation Manual This parameter is used to specify if the LUO transaction specified in the CAFCCMD ACTION filed is to be continued or is the final response Coding SESSION CONT is the equivalent of coding a C in column 72 of a CAFC control card and coding SESSION END is the equivalent of coding a E in column 72 of a CAFC control card NORESPONSE This parameter is used to specify if the LUO CTLFILE ACTION Copyright 2004 transaction specified in the CAFCCMD ACTION field is not expected to give a response Coding NORESPONSE is th
161. e selection menu The screen lets the user request jobs from the LOCO submit library be submitted for batch execution by the LOCO subsystem SS CDDF5100_MANUAL EXTRA Persona I Client File Edit View Tools Session Options Help LOCO SUBMIT DSNAME NETEC LOCO33 JCLLIB Row 00001 of 2821 Command gt _ Scrol gt PAGE Name Prompt Size Created Changed ID ASMLOCO 97 2000 07 17 2002 08 18 12 03 08 U2TEC8 ASM2016 60 2001 11 15 2002 02 16 13 42 58 U2TEC8 IEFBRI4 0 2002 07 13 2002 08 07 18 17 48 U2TEC8 LOCB 25 2000 07 22 2002 08 25 10 47 23 U2TEC8 MANYNTOS 3 2002 04 13 2002 04 13 09 24 55 U2TEC8 TASM 197 2002 03 29 2002 03 29 13 42 18 U2TEC8 TBLDR 25 2000 07 22 2001 09 29 10 50 15 U2TEC8 TCMD 2001 09 03 2002 07 06 17 59 44 U2TEC8 TDUMP 6 2002 03 29 2002 03 29 12 54 03 U2TEC8 TIGNT 11 2002 03 29 2002 03 29 11 23 38 U2TEC8 TINIT 11 2000 07 22 2002 07 13 15 42 13 U2TEC8 TINTF 13 2001 09 01 2001 09 01 17 26 30 U2TEC8 TLOG 34 2001 09 03 2001 09 03 10 02 12 U2TEC8 TREPT 13 2001 07 03 2002 03 28 10 03 59 U2TEC8 TSIMUL8 23 2002 03 29 2002 03 29 16 24 09 U2TEC8 TTEST 6 2000 07 22 2001 09 01 08 20 15 U2TEC8 TWQE 23 2002 07 13 2002 07 13 14 55 11 U2TEC8 TWTO 5 2002 03 29 2002 03 29 14 16 03 U2TEC8 ZAP 12 2001 09 03 2001 09 03 11 20 23 U2TEC8 xxEnds 00 7 Connected to host 10 1 1 20 The screen is th library browsing editing or submitting to batch thro member selection screen for The
162. ecuting has been reloaded since displayed is aborted Redisplay command again the queue and attempt to The LOCO table xecute th LCON0150 CORRECT DATES AND RESUBMIT JOB Explanation LOCOMAIN found an error in the dates specified for the REPORT option The error is detailed in another message User Response Correct the erroneous date and resubmit the job LCON0151 PARM VALUE TOO LARGE MAX SIZE 79 BYTES Explanation LOCOMAIN received an execution time PARM value larger than 79 bytes User Respons Reduce the size of the PARM and resubmit the job LCON0152 DATE IN PARM HAS INCORRECT FORMAT Explanation LOCOMAIN received an execution time PARM for the User Response Copyright 2004 REPORT option and found the date was not of the format MM DD YY as required Correct the erroneous date and resubmit the job Proprietary Product of NETEC International Inc Page 176 Logical Console Operator User Manual 11 12 05 LCON0153 Explanation User Response LCON0154 Explanation User Response LCON0155 Explanation User Response LCON0156 Explanation User Response LCON0157 Explanation User Response LCON0158 Explanation User Response LCON0159 Explanation User Response Copyright 2004 MUTUALLY EXCLUSIVE DATES SPECIF ED LOCOMAIN received an execution REPORT op
163. elds display the current si tatus of the LOCO internal traces This field indicates whether th master internal is active This field indicates whether LOCO is to trace all WQE ORE activity This field indicates whether LOCO is to trace all CICS activity This field indicates whether LOCO is to trace all message activity D access to the LOCO xxxx SSI to access to LOCO subsystem LOCO xxxx STATUS to allow display access XXXX The one to four character LOCO subsytem name Copyright 2004 Proprietary Product of NETEC International Inc Page 112 Logical Console Operator User Manual 11 12 05 Performing LOCO Table Maintenance Entering option 2 on the main selection menu and pressing the ENTER key displays the LOCO Table Maintenance menu The following screen will be displayed This screen contains a member list of all the LOCO tables current present in the LOCO table library being used by the LOCO subsystem specified under operational parameters J CDDF5100_MANUAL EXTRA Personal Client 8 xl LOCO TABLE DSNAME NETEC LOCO33 TABLES Row 00001 of 00006 Command gt _ Scroll gt PAGE Name Prompt Size Created Changed ID CAFCTABL 89 2002 03 26 2002 08 31 15 39 09 U2TEC8 DINOIPL 35 2001 09 01 2001 09 08 08 32 30 U2TEC8 DINOTSTI NEWTABLE 208 2001 09 08 2002 10 19 11 53 57 U2TEC8 TESTTABL 208 20
164. ent LCON matches messages and events to user defined tables OPERATIONS and issues commands EXTENSIONS AUTOMATED MVS Operating system processes user commands JES2 JES3 CICS Proprietary Product of NETEC International Inc Copyright 2004 Page 14 Logical Console Operator User Manual Installation Guide Distribution Tape 11 12 05 The LOCO distribution tape contains three standard labeled files FI LE 1 2 DATA SET NAME LOCO LOAD LIBRARY DESCRIPT ON LOCO program load modules LOCO SOURCE LIBRARY LOCO installation JCL run JCL and sample tables LOCO ISPF ISPPLIB LOCO ISPF ISPMLIB Installation Overview Copyright 2004 tep tep tep tep tep tep tep tep tep tep T 10 Load the four distributed P Considerations for the upgrade LOCO by LOCO LOCO ISPF Panel library LOCO ISPF Message library DS files to your disk installation of Make the LOCOIN I program available Define security for the LOCO TSO Define LOCO as a subsystem to MVS Install the LOCO TSO interface Determine the authorization technique to be used at IPL Interface Print and review the sample LOCO control tables Optionally add LOCO Automatic Restart Manager Define LOCO control table Proprietary Product of NET
165. er catalog Usually this i library following JCL will copy distribution library to a PI that has the high level qualifier of SYS1 LOCOINST LOCOCOPY SYSPRINT INPUT OUTPUT y Copyright 2004 the LOCO DS called SYS1 LOCO LPALI SVC from the me nethod of providing authorization for LOCO lling a LOCO supplied authorization SVC S a The B JOB Noi Td teu AES eater Wt Deo s EXEC PGM IEBCOPY DD SYSOUT DD DSN your load pds DISP SHR DD DSN SYS1 LOCO I PALIB DISP NEW CATLG D EI ETE Proprietary Product of NETEC International Inc Page 20 Logical Console Operator User Manual 11 12 05 UNIT SYSDA SPACE TRK 5 1 1 RLSE SYSIN DD COPY I INPUT O OUTPUT SELECT M LOCOSVC The SVC must be defined as a type 3 or 4 SVC This can Copyright 2004 be done through members The IE SVCs found in yo following is an modification of two SYS1 PARMLIB ASVCxx m mber defines th ur operating environment IEASVCxx member wher example of an current user The DFHCSVC DFHHPSVC I1GC205 several user SVCs have been defined SVCPARM 255 REPLACE TYPE 2 SVCPARM 254 REPLA
166. ermission to manipulate LOCO trace LOCO ssss TRACES Ssss Subsystem Name Example LOCO TRACES Generic profile that will match any request to modify the trace options for any LOCO subsystem Users permitted with READ access to this profile will be able to modify the trace options for any LOCO TSO interface connecting to any LOCO subsystem LOCO LOCA TRACES Specific profile that will match users who are trying to modify trace options for the LOCO subsystem named LOCA Proprietary Product of NETEC International Inc Copyright 2004 Page 145 Logical Console Operator User Manual 11 12 05 Users permitted with READ access to this profile will be able to modify trace options for the LOCO TSO interface connecting to LOCO subsystem LOCA The RACF commands necessary to define these profiles are RDEFINE FACILITY LOCO TRACES UACC NONE RDEFINE FACILITy LOCO LOCA TRACES UACC NONE Permission to manipulate LOCO resources LOCO sSSSS RESOURCES XXXXXXX SSSS Subsystem Name BROWSE User can examine the state of LOCO resources HOLD User can HOLD and Release resources ACTIVATE User can Activate and deactivate resources Example LOCO RESOURCES BROWSE Generic profile that will match any request to browse the LOCO resources on any LOCO subsystem Users permitted with READ access to this profile will be able to examine the LOCO resources on
167. es x DII i 41 Starting the LOCO SubSySteMm oseke dew eck eeu ee ee x Ee ee ees 43 UtiigtyGurdeueksst enh ett tte Bet te ee a aoe eee dee es 46 Creating and Maintaining LOCO Tables eee eee ee ee ee ee ee 46 Creating LOCO Tables with LOCOBLDR sens 3 Seles bee wg UR SUR Us a 46 Creating LOCO Tables with the LOCO TSO ISPF Interface 46 Managing LOCO Table DOUCE prainha drun tee wee tems ee Due Ue 47 EMP ORT Command 2a aen Ge eene eaaa a fe e a a a T UE edb te Vee ota add a ea 48 EXPORT Commands Se eia a ans aloes ay baal wwe amp rU e E E eee we E E d 50 Control Taole Syntax wee ase Sele ee EE EER EE XE I ERI UH 52 WILDCARD USAGE a eee se Eee ee eRe Ee ee Ee Ee Re wee eRe eee Ee Ee ee eee e UE 52 Variable Symbod 89 eu uud ue aad eens een dae ed aed o eg 52 DEFINE Statement cege ei ede ed ew eee E Ewe re See iene eee ie wl 56 STARTUP Statements e ee oot e Ret ue Ee Uo Me ke air toe ale Ade s Hen al d 58 SHUTDOWN Statement as s gesendet ele erm Roe nee Ie me eee UL ws 61 WTO Statement ise beg xev m Eu Re Fu xemrRc eee ERES qe s 64 MAJOR COMMA Aes Aes ma fete ts ke He Seb de valete aede deeds des oto e Use ede ire De De Weeds Oe ee a8 68 WOR Statement cde ere s ke ck Uo uec Bie Se Wile eae Re Ee Re RR See eae es 73 a Commands sede eux ls a E aca eame Eu ee E ORE CO ec o pas e 77 COMMAND Statement 2 2 gpr E aE EE EE ETE EEE E EE E LEE etd ete AKO STH Tig 80 PREME Command eB ee E A NN E n mS E tat EU ANE 82 EVENT endotstep St
168. esponse none LCON0766 LOCO ACTIVITY LOG SUBTASK INITIALIZATION COMPLETE Explanation This is an information message indicating the LOCO activity log subtask has completed initialization Issued by LOCOALOG User Response none LCONO767 LOCO ACTIVITY LOG SUBTASK TERMINATION COMPLETE Explanation This is an information message indicating the LOCO activity log subtask has completed termination Issued by LOCOALOG User Response none Copyright 2004 Proprietary Product of NETEC International Inc Page 192 Logical Console Operator User Manual 11 12 05 Messages from LOCOINIT Messages ar will be changed to the current subsystem name by LOCO execution time then th LCON0800 LCON0899 shown with LCON as th message prefix This prefix NIT at If LOCOINIT is run on behalf of subsystem LCOG mess LCONO800 Explanation User Response LCONO801 Explanation User Response LCON0802 Explanation User Response LCON0803 Explanation User Response LCON0804 Explanation User Response Copyright 2004 ages will be LCOG800 LCOG801 etc xxxx VERSION x x mm dd yyyy INITIAL This is a confirmation that LCON subsystem xxxx has been has been initialized by LOCOINIT release x x which was assembled on mm dd yyyy None ZED xxxx NOT DEFINED AS A SUBSYSTEM The PARM SSN xxxx specified a subsystem name unknown to
169. eyword used to There are 32 user vars time of table ent ONS A RESET may TEXT and specifies an amount is to a ITEXT and recycle the LOCO executing any of the following ACTI entry will then wait for the insert values be of utomatically terminate the try without The table the next ENDOFSTEP into label SUV 32 The symbol L must A1 tex obal symbol ed SUV 1 immediately foll Svars and blanks Proprietary Product of NETEC International Inc lowing the will the current value of the target user Svar preceding the Page 85 Logical Console Operator User Manual 11 12 05 CAFCCMD Statement This stat to be performed by LOCO whenever the COMMAN MVS console or encountered as an action of anot The first as specified on ment delineates a CAFC action or series of CAFC actions character of th the DEFI requires the presenc separate product that LOCO utilizes the CAFC ba The order of th Keywords foun to the entire CAFCCMD request important found aft CAFCCM IMEOUT Copyright 2004 ter an ACTI To fully understand review the Cl tex TI of can e text NE stat D text is keyed on the ther LOCO command must be the LOCO command prefix Ihe use cement the NETEC CAFC produci be licensed from NETEC tch interface program to make C
170. f 80 number of characters in an input tement that will be scanned by LOCOBLDR The default is 72 expressed as Rn and Dn respectively tions range from 1 through 16 for descriptors and 1 por ar thru 128 f described Codes by commas or routes and correspond in the IBM manual Routing Ih codes specified in TO T and Proprietary Product of NETEC International Inc the occurrence of any character for matching HH MM SS and represents an s keyword the SLEEP keyword of the SLEEP is not explicitly coded on the then the global SLEEP default is zero Tut A typical tatement cards may have a series of routing and descriptor codes he numeric he values Descriptor Any combination of codes may be keyed separated the ROUTE operand Page 56 Logical Console Operator User Manual 11 12 05 here will override the default of R2 D7 for LOCO messages produced by ACTION Fa QLIMIT Copyright 2004 which The nun LOCOMAIN processing When the count of messages waiting for processing by LOCOMAIN reaches this number succeeding WTOs WTORs are lost to LOCO The default value is larger number may be necessary to handle 1024 A dataspace DS Y waiting on LOCOMAIN e g during VTAM initialization or when LOCOMA not reside in a special group the QI M tab
171. f output be activated through the after LOCOMAIN has begun the LOCO This option should request option The option can also LOCO TSO interface execution of NETEC will produce REPORT PARM field will report mode output have been taken real time want to times ar When to SYSPRINT Report check that the actions that wer is executed as if LOCO were running Specific dates and times cause LOCO in report if mode is LOCO int specified The presence of the REPORT keyword in the to execute in mode the actions that LOCO were executing in useful when you tables are nded LOCO will would taking Report mode between These dates and through the LODATE and HIDATE parameters that are specified on the LOCOMAIN execution PARM DATE mm dd yyyy This field or Specified in the LOI the LOCOMA field specifies for report mode the dat execution DATE and HI is required if the REPORT keyword is N PARM field that LOCO is to use field DATE This LODATE mm dd yyyy This fiel is specified in This field specifies LOCO is to use for report n the b d is required if the REPORT keyword the LOCOMAIN PARM field ginning date that node execution Copyright 2004 Proprietary Product of NETEC International Inc Page 39 Logical
172. fies what action he would like LOCO to take against the following EVENT queue entry The valid actions that can be specified for a queue entry are Action Description H Hold the EVENT queue entry Prevent LOCO from taking action should actions required to execute this queue entry be meet Proprietary Product of NETEC International Inc Copyright 2004 Page 140 Logical Console Operator User Manual 11 12 05 R Release the EVENT queue entry Release LOCO to take action should actions required to execute this queue entry be meet D Delete this EVENT queue entry LOCO will remove the entry from the EVENT queue To replace th ntry in the queue will require the LOCO table be reloaded Security Requirements To manipulate these resources requires READ access to the following SAF Profiles LOCO xxxx SSI to access the LOCO subsystem LOCO xxxx QUEUES EVENT BROWSE to display queue entries LOCO xXxxx QUEUES EVENT HOLD to HOLD RELEASE queue entries LOCO xxxx QUEUES EVENT DELETE to DELETE queue entries XXXX The one to four character LOCO subsytem name Proprietary Product of NETEC International Inc Copyright 2004 Page 141 Logical Console Operator User Manual 11 12 05 Displaying and Manipulating the COMMAND Queue The following screen is displayed when the user selects the COMMAND queue for manipulation I CDDF5100_MANUAL EXTRA
173. g the compression of a LOCO library has failed Check previous messages for additional information LOCOCPRS none LIBRARY COMPRESSION COMPLETED RC xx This is an information message indicating the compression of a LOCO library has completed with return code xx LOCOCPRS none COMPRESSING a b c d This is an information message indicating the LOCO library a b c d is being compressed LOCOCPRS none LOCO ACTIVITY LOG SUBTASK BEGINNING INITIALIZATION This is an information message indicating the LOCO activity log subtask is beginning initialization LOCOALOG none LOCO ACTIVITY LOG SUBTASK TRACE ACTIVATED This is an information message indicating the LOCO activity log subtask has activated internal trace LOCOALOG none LOCO ACTIVITY LOG SUBTASK TRACE DEACTIVATED This is an information message indicating the LOCO activity log subtask has stopped internal tracing LOCOALOG none Proprietary Product of NETEC International Inc Page 191 Logical Console Operator User Manual 11 12 05 LCONO764 LOCO ACTIVITY LOG SUBTASK BEGINNING TERMINATION Explanation This is an information message indicating the LOCO activity log subtask is beginning termination Issued by LOCOALOG User R
174. hat particular cpu The CPUID value may contain wildcard characters The filter condition may be reversed by preceding the cpu id value by the symbol E G CPUID CPUA The tsoid is a 7 digit value representing the TSO user id of the submitter of the job which produced the WTO triggering event It is a filter keyword WTOR actions will only be performed for WTORs from jobs submitted by that TSO user The TSOID value may contain wildcard characters The filter condition may be reversed by preceding the TSO id value by the symbol E G TSOID PC1 The origin is an 8 byte value representing the JES sysid from CTXTSYSN field of the CTXT WTOR actions will only be performed for WTORs from matching origins This filter is particularly useful for JES3 environments Note Whenever multiple filter keywords are coded all criteria must be satisfied in order for the actions to be performed The filter keywords are functionally connected by a logical AND operator WAITIME WAITEXT Copyright 2004 Ihe time is of the format HH MM SS and represents an amount of time not a clock value A WAITIME may be coded after an ACTION causing a wait for that amount of time before proceeding to the next ACTION The text is any string of characters including the WILDCARD A WAITEXT may be coded after an ACTION causing a wait until that text string is issued
175. he IKJTSOxx SYS1 PARMLIB member to add the LOCO subsystem interface authorized program LOCOTSPZ LOCOTSPZ is called through the TSO Service Facility and needs to be added to the AUTHTSF list of programs The following is an example of this addition AUTHTSF NAMES PROGRAMS TO BE AUTHORIZED WHEN CALLED THROUGH THE TSO SERVICE FACILITY xq LOCOTSPZ LOCO TSO INTERFACE PGM Addition CSFDAUTH ICSF iy sp IEBCOPY EJ ICQASLIO Le RF IKJEFF76 x Proprietary Product of NETEC International Inc Copyright 2004 Page 31 Logical Console Operator User Manual 11 12 05 Step 7 Define security for the LOCO TSO Interface The LOCO TSO interface utilizes an external security manager such as RACF ACF2 or Top Secret to verify a user s functional authorization SAF calls are made through out the interface to verify the user s permission to execute the LOCO function that is being attempted If the user is found to be unauthorized access to the LOCO function is denied Profile checking occurs at two levels First the users ability to access the LOCO subsyst tem interface is determined users ability specified LOCO TO user s authorization fails or LOCO subsystem is denied the LOCO security installation profiles complex as the requirements for each individual xecute the request subsystem is checked If access to the Through the scheme can
176. he TABLEDSN keyword the source to that contains ually TABLEDSN e f g h is the DSNAME of the LOCO table library that contains the source to be exported The TABLEDSN must be a PDS that contains LOCO tables The TABLEDSN keyword is mutually exclusive with the TABLEDD keyword LIST YES NO indicates that the source is to be listed on the SYSLIST data set when LIST YES is specified The default is NO FORMAT IEBUPDTE indicates that the exported output should contain ADD or REPL control cards between members If the output data set is a sequential data set the ADD or REPL control cards will separate each member with a ENDUP control card as the last Proprietary Product of NETEC International Inc Copyright 2004 Page 50 Logical Console Operator User Manual 11 12 05 MEMBER Copyright 2004 will start with a ADD member If the output is a P or REPL control end with a ENDUP The default is not in IEBUPDTE format control cards DS each member of the PDS card and clude mmmmmmmm indicates the member name that is to be exported The member name may terminate wi asterisk indicating all members of the LOCO cha tab exported If the output da t is a sequ th an t
177. his flag indicates whether or not the LOCO TSO interface is to log commands this user issues to the ISPF log Proprietary Product of NETEC International Inc Copyright 2004 Page 108 Logical Console Operator User Manual 11 12 05 Log Responses This flag indicates whether or not the LOCO TSO interface is to log responses to commands this user issues to the ISPF log Trace TSO Activity This flag indicates whether or not to create a NETEC International internal trace of the LOCO TSO interface NETEC International technical support personnel may ask that this flag be set to Y to assist in problem resolution The following parameters are used to allocate the temporary dataset create as part of the LOCO table compilation process Unit Type This specifies the DASD unit type to be used when dynamically allocating the LOCO table compilation output data set Volume Name This specifies the volume serial number to be used when dynamically allocating the LOCO table compilation output data set This parameter is optional Allocation Unit This specifies the allocation unit to be used when dynamically allocating the LOCO table compilation output data set The valid options are TRK CYL or BLK Primary Quantity This specifies the primary quantity of the allocation unit to be used when dynamically allocating the LOCO table compilation output data set Secondary Quantity This specifies the secondary qu
178. horization SAF calls are made through out the interface to verify the user s permission to execute the LOCO being attempted If the user is found to be unauthorized access to the LOCO function is denied levels First the users ability interface is determined function that is Profile checking occurs at two to access the LOCO subsystem Second the users ability to execute th requested function within the specified LOCO subsystem is checked If at any time the user s authorization fails access to the requested function or LOCO subsyst the use of generic profiles simple or as complex as paragraphs describe the SAF profiles that must be created to permit a user access to Security Profiles the LOCO TSO interface tem is denied Through the LOCO security scheme can be as the installation requires The following The user must have read access to the SAF profile to be considered authorized for the requested function of subsystem All profiles are defined in the FACILITY class The following describe the profiles that are checked for the function described Permission to access the LOCO subsystem interface LOCO ssss SSI ssss Subsystem Name Example LOCO SSI LOCO LOCA SSI Generic profile that will match any request to access any LOCO subsystem Users permitted with REA D access to this profile will be
179. ied in its control tables or interface to other NETEC International products such as the CICS Application File Control facility and the DBControl Batch Interface program If LOCO is started early in your IPL sequence it will oversee all of your procedures including JES initialization Conversely LOCO will gracefully shut down NCCF and JES for scheduled IPLs or table maintenance with one command LOCO never Sleeps never forgets and never comes in late It always remembers what to do for each shift no matter what day it is Because LOCO dramatically reduces a data center s operating complexity less skilled people can adequately manage day to day operations Since LOCO centralizes and qualifies system activity a small staff can manage a large center even in the Proprietary Product of NETEC International Inc Copyright 2004 Page 6 Logical Console Operator User Manual 11 12 05 shadow of growing workloads LOCO frees your operations and technical staff members from unnecessary and tedious console monitoring so they can concentrate on more important activities The principle features of LOCO include e A syslog analysis program to suggest possible candidates for automatic replies or actions e A simple fill in the blanks language to specify triggering events and actions e Automatic replies to WTORs WTOs and WTPs e Automatic ac
180. internal reader The operand is a member name located in the LOCO SUBMIT library Example gt MYJOB COMMAND OPERANDS STOP Command The STOP command will immediately terminate the LOCO task There are no operands COMMAND OPERANDS Proprietary Product of NETEC International Inc Copyright 2004 Page 98 Logical Console Operator User Manual 11 12 05 STATUS Command The STATUS command will display several messages on the MVS console containing information about the current LOCO status The name and compile time stamp of the current LOCO control table is displayed the activation status and processing counts of WTO WTOR and TIME events are displayed the last LOCO activity is displayed There are no operands COMMAND OPERANDS LOAD Command The LOAD command will immediately replace the current control table with the one specified as tabname The operand TABLE may alternately be specified as MEMBER If new tabname is not found the current table remains in effect COMMAND OPERANDS Q8 LOAD TABLE tabname Proprietary Product of NETEC International Inc Copyright 2004 Page 99 Logical Console Operator User Manual 11 12 05 QDEACTIVATE Command Ihe DEACTIVATE command will cause LOCO to ignore the specified type of triggering activities until reACTIVATEd Time initiated events WILL be discarded as they age Any combi
181. ion option option option option option time substitut text is blank ed al tring of characters and may contain ion as the or has leading blanks it must be enclosed in single quotes t Example REROUTE ACTI ON Copyright 2004 REPLY t yn This operand will change the routing and desc codes of the original WTOR The routing code riptor S are keyed as Rn where n ranges from 1 through 128 descriptor codes ar ranges from 1 through 16 keyed similarly as Dn wh Multiple routes an ere n d descriptors may be keyed in any order separated by commas described in The actions imp IBM s manual Codes command 2 Proprietary Product of NETEC International Inc Exampl The text is one of two types of commands a LOCO built in command keyword may be repeated on the WTOR statement ELE lied by thes ed Routing and e REROUTE I D2 R16 codes a 1 The AC r Descriptor an MVS TION The Page 73 Logical Console Operator User Manual 11 12 05 LOTI ME ACT time substitution or local for real ION text may contain global The time is in the format of clock value It is a filter will only be performed on or of day ME DATE LODATE IDATE WEEKDAY The time is in clock value It the format of
182. ions to be performed The filter keywords are functionally connected by a logical AND operator Ihe time is of the format HH MM SS and represents an of time not a clock value This keyword will his entry to be repeated at the specified time l until the time crosses the UNTIL time value if UNTI the tim day it Default The tim clock v When th to cont WAITIME WAITEXT RESET Copyright 2004 Ihe tim amount coded a time be The tex WILDCAR causing WTO thr a WTO Note The tim amount coded o L is specified If UNTIL is not specified as e passes over the original time of the next is synchronized back to the original time is 24 00 00 e is of the format HH MM SS and represents a alue The UNTIL value marks the REPEAT limit e statement reaches its UNTIL limit it is set inue at the original time the following day e is of the format HH MM SS and represents an of time not a clock value A WAITIME may be fter an ACTION causing a wait for that amount of fore proceeding to the next ACTION t is any string of characters including the D A WAITEXT may be coded after an ACTION a wait until that text string is issued as a ough the MVS system After the text is seen as the next ACTION is performed Both WAITIME and WAITEXT may be coded between ACTIONS In that case the second A
183. is a filter will only be performed on or time of day Note HITIME and LOTIME may define a time range date mu st foll e DD YYYY It ly be performed date must fol D DD YYYY It Ly be performed date must fol So9S8n98n e DD YYYY It nly be performed Oo Note OW is a on OW is a on OW is a on the exact filter keyword Svars HH MM SS and repr keyword WTOR ac after that partic esents a tions ular time HH MM SS and repr keyword WTOR ac before that parti be specified toge of MM DD WTOR act format tha the fil or the fil t par exact ter keyword date of MM DD WTOR act ticular format after that particular exact format ter keyword of MM DD WTOR act or before that particular HIDATE and LODATE may be specified together esents a tions cular ther to YY or ions will YY or ions will date YY or ions will date but DATE may not be specified with either of them If any of the above date operands is specified as MM DD YY LOCO will provide the complete YYYY internally through 50 if YY is higher than 50 be set to 19 The string of charac the week beginning with Monday Ihe WTOR aci weekday positions which contain the ch Example WEEKDAY MTW to be performed on
184. is case only the reply var label is specified in the SET operand E G SET R42 Proprietary Product of NETEC International Inc Copyright 2004 Page 76 Command Logical Console Operator User Manual time ACTION text CPUID cccc DATE date LODATE date HIDATE date WEEKDAY mtwtfss The time is a clock value in the format HH MM SS will begin at the time of day specified REPEAT time UNTIL time WAITIME time WAITEXT tex RESET time t SET SUV nn text The text is one of two types of con command 2 a LOCO built in command keyword may be repeated on the statement one ACTION must be coded Svars for real internal be performed o tS DD YYYY It is be performed EHdosHos z Bos o Copyright 2004 E G CPUI te must fol te must fol te must fol D YYYY It is ly be performed low the exact DD YYYY It is a filter keyword on that particular low the exact a filter keyword that partic low the exact a filter keyword 11 12 05 The actions required option option option option option option option option option option option nmands 1 an MVS The ACTION The ACT time substitution D CPUA on or after It is a fill The CPUI At least ON may
185. l gt CSR STARTUP UNTIL 24 00 00 HITIME 24 00 00 LODATE 2002 001 HIDATE 2002 365 WEEKDAY MTWTFSS CPUID NTC1 ACTION K E D L 01 WAIT IME 0 01 20 ACTION K A NONE L 1 WAITEXT WAI TTEXT RESET 82 00 00 ACTION K A NONE L 2 ACTION UV 11 1 10 SET UV 1 VARIABLE1 SET UV 1Q SUV 1 2 3 KXKEKKNKKKKEKKXKKKKKKXXKEKKXK END OF QUEUE XXKXKKXKKKKNKKXKEKKKKEKKNKKXK 6 00 1 03 15 j Connected to host 10 1 1 20 T 11 20 AM From this screen the user can delete hold or release a specific entry on the LOCO STARTUP queue Each queue entry is formatted on multiple lines Before the beginning of a queue entry is an action field where the user specifies what action he would like LOCO to take against the following STARTUP queue entry The valid actions that can be specified for a queue entry are Action Description H Hold the STARTUP queue entry Prevent LOCO from taking action should actions required to execute this queue entry be meet Proprietary Product of NETEC International Inc Copyright 2004 Page 136 Logical Console Operator User Manual 11 12 05 R Release the STARTUP queue entry Re action should actions required to execute this queue entry be meet D Delete this STARTUP Security Requirements queue entry LO entry from the STARTUP queue the queue will require the LOCO tabl TOE lease LOCO to take CO will remove the To
186. l XXX 120 global XXX 120 global rr 4 global rr 4 global rr 4 global rr 4 global XXXX 120 local XXX ee ne 80 local 333535353 8 local SSSSSSSS 8 local JOBFHH tH 8 local ttttttt 7 local XXXXXXXX 8 local XXXX s ie xx 120 local These Svar symbols may be keyed in the ACTION operand value and they will execul names be replaced with their real time values at the time of tion of the ACTION These variable symbols will have their replaced by their exact current length of data thus the resul ting text string will expand or contract accordingly Optionally any of the Svars may be immediately followed by a substring expression specifying the beginning position and length of a portion of the var value to be extracted for substitution The format is Svar beg len Examp les If SJOBNAME has the value ABCDEFGH then SJOBNAME 1 8 is ABCDEFGH SJOBNAME 1 3 is ABC SJOBNAME 7 1 is G The Svars have their values set as follows SCPUI D STIME SWEEK SUV 1 DAY UV 32 Copyright 2004 This value is set to the 4 digit value of the MVS CPU id field at LOCOMAIN startup time This value and the various SDATEs are set to current real time values as LOCOMAIN is dispatched due to a WTO or time triggering event This value is set to the name of the current weekday These 32 generalized user varia
187. l the next clock time of 08 15 and issue the MVS S TSO th text CY IEE362A messages for the instructs LOCO to interrogate each WTOR h the MVS system for the leading characters characters are found LOCO will where xx is the command S LOGRECA and 2 then wait for two minutes before issuing the MVS command S LOGRECB Copyright 2004 Proprietary Product of NETEC International Inc Page 10 Logical Console Operator User Manual 11 12 05 characters would produce The COMMAND card instructs LOCO on the MVS console beginning with Whenever the command the MVS command corresponding characters in the keyed command D Uppi eorla DAW ype UIDI Processing Narrative LOCO is initialized at mechanism controlled by the program module LOCOINIT is defined in IEFSSN via the user the LOCOMAIN start up param execution statement to watch ap with the followed by any is keyed LOCO will issue for a command keyed three the D285 replaced by e g IPL time by the standard MVS subsystem IEFSSN member of PARMLI invoked for each LOCO subsystem B Ihe The amount of CSA used by LOCO is determined rs There is a ntered via the PARM field on minimum amount of both below the line and above the line CSA necessary for LOCO to execute Th in CSA queue headers and subsystem exit of WTO the DS YES is
188. le only uti Proprietary Product of NETEC International Inc nber is the upper limit on backlogged WTO WTORs LOCO has stored in either CSA DS N or the large bursts of WTOs when LOCOMAIN is slow to dispatch IN does high priority performance If the LOCO WTO WTORs are held in CSA I make be adjusted downward so that LOCO can lize a maximum of 50 of the CSA available at load time DS N Page 57 Logical Console Operator User Manual 11 12 05 STARTUP Statement This statement delineates an action or series of actions to be performed by LOCO as it originally starts execution STARTUP is ideal for IPL activities If a table is loaded into LOCO during execution by the LOAD command the STARTUP actions are NOT performed STARTUP ACTION text required CPUID cece optional LOTIME time option HITIME time option DATE date option LODATE date option HIDATE date option WEEKDAY m option WAITIME ti option WAITEXI option RESET time option SET UV nn text option ACTION The text is one of two types of commands 1 an MVS command 2 a LOCO built in command The ACTION keyword may be repeated on the STARTUP statement as many times as needed At least one ACTION must be coded The ACTION text may contain global Svars for real time substitution
189. le AFCT2016 The DEFACB Y Facility this parameter s Ins the CICS Application File Control Facility Installation Manual ons use the er is set to format of tallation Manual DIRECT specify the DIRECT Y immediately CAFC Table File without first checking that the region is active and the Table file the requests to that Subsequent If you are certain a DIRECT parameter to CAFC through the keyword on target CICS r the CAFCCMD s egions tatement the B I the For a complete description the CICS Application File Control is down use the default ACB name DEFACB nyn the to connect to all regions even though specific ACB names have been coded in DEFACB of you can CAFC will apply the requests for this region to the The direct region will f ail requests to other regio the respec useful if of the DI description File Contro tiv you need restart status for IRECT parameter is D updates are performed the CICS region is down is already open with an open error If ns will be processed if CAFC Tabl files ar the next region TRECT available DIRECT is to synchronize or override the desired startup Tya of this parameter s l Facility Installation ME EXCI
190. le Control TERMDLAY A tin compl format of the TERM For a complete description of this parameter s Copyright 2004 t befor Facili DELAY is exec Installation Manual DELAY keyword uted after urn code is zero DELAY hh mm ss the CI The For a CS ne delay for the Batch Terminal be invoked to allow the started user transaction the VTAM session ty is terminated DLAY parameter is TERM Installation Manual Processor LUO to The may DLAY hh mm ss Proprietary Product of NETEC International Inc th Page 87 Logical Console Operator User Manual 11 12 05 FREEDSN DEFACB Cj Faci Manual ICS Application File Control Install ation lity A CAFC Table File dsname switch may be invoked by the FREEDSN keyword parameter wy CAFCCMD CTLF If thi S parameter the is set to the Table File data set name specified in the LE keyword will be freed and Table File data set name coded in the AFCT2016 table will be allocated and used by LOCO FREEDSN Y see If you wish The format of the FREEDSN is For a complete description of this parameter to force the LOCO to to connect Association parameter keyword parameter LOCO will use is to the target CICS regi If this paramet 62 C CS Tab
191. le is incorrect The object table may have been damaged after compilation or LOCOBLDR may have created it in error The table may have been damaged internally by LOCOMAIN Insure that the release levels of LOCOBLDR and LOCOMAIN are the sam Recompile the LCON table with LOCOBLDR if the error persists contact NETEC Technical Support Proprietary Product of NETEC International Inc Page 171 Logical Console Operator User Manual 11 12 05 LCON0123 Explanation User Response LCON0124 Explanation User Response LCON0125 Explanation User Response LCON0126 Explanation User Response LCONO127 Explanation User Response Copyright 2004 NVALID QUEUE TYPE The structure of the LCON object table is incorrect The object table may have been damaged after compilation or LOCOBLDR may have created it in error The table may have been damaged internally by LOCOMAIN Insure that the release levels of LOCOBLDR and LOCOMAIN are the same Recompile the LCON table with LOCOBLDR if the error persists contact NETEC Technical Support NVALID REPLY NUMBER The reply number for a WTOR received from IEAVMXIT or from LOCOS35 is not numeric It is possible that a WTO text matched your WTOR table entry in which case these is no REPLY number available Xxxx NOT INITIALIZED LOCOINIT EFSSN
192. llowing describe the possible parameters that can be specified Parameter Values Description SSN XXXX XXXX is the LOCO subsystem name to be used for this execution of LOCOMAIN This is a required paramter SVC XXX SVC number that was assign to the LOCO authorization SVC at installation time DS Y N Y indicates the WTO blocks are to be held in a LOCOMAIN created dataspace N indicates the WTO blocks are to be held in CSA DS N is the default MEMBER XXXXXXXX XXXXXXXX 1s the member name of the LOCO table to load and execution at LOCOMAIN initialization time This is a required parameter CAFC Y N Y indicates LOCOMAIN should include CAFC support at initialization time N indicates that support will not be available during this execution of LOCOMAIN CAFCzN is the default DBCT Y N Y indicates LOCOMAIN should include DB Control Batch Interface support at initialization time N indicates that support will not be available during this execution of LOCOMAIN DBCT N is the default NOREISSUE LOCO should ignore WTOs that have been reissued by XCF in a Sysplex environment A reissued message is specified by z OS via the WOERISS bit being on in the WQEFLG1 field of the WQE TRACE The presence of the TRACE keyword in the PARM field will cause LOCO to produce an internal
193. mmas The actions implied by these codes are described in IBM s manual titled Routing and Descriptor Codes Example REROUTE D3 R7 The time is in the format of HH MM SS and represents a clock value It is a filter keyword WTO actions will only be performed on or after that particular time of day DATE LODATE HIDATE WEEKDAY Ihe time is in the format of HH MM SS and represents a clock value It is a filter keyword WTO actions will only be performed on or before that particular time of day Note HITIME and LOTIME may be specified together to define a time range e date must follow the exact format of MM DD YY or DD YYYY It is a filter keyword WTO actions will ly be performed on that particular date e date must follow the exact format of MM DD YY or DD YYYY It is a filter keyword WTO actions will ly be performed on or after that particular date e date must follow the exact format of MM DD YY or DD YYYY It is a filter keyword WTO actions will ly be performed on or before that particular date soogSuosg O 5 Note HIDATE and LODATE may be specified together but DATE may not be specified with either of them If any of the above date operands is specified as MM DD YY LOCO will provide the complete YYYY internally If YY is in the range of 00 through 50 then th
194. mpletes None 0F 0 AL2 102 0 C 0177 CURRENT QLIMIT WOULD UTILIZE EXCESSIVE LIMIT HAS BEEN RESET TO d E EEEE Follows 119 contains bad command TABLE XXXXXXXX yyyy ddd hh mm ss The LCON table currently loaded is XXXXXXXX It was compiled by LOCOBLDR on date yyyy ddd at time hh mm ss None This message produced by the STATUS command Proprietary Product of NETEC International Inc Page 180 Logical Console Operator User Manual 11 12 05 LOCNO181 Explanation User Response LCON0182 Explanation User Response LCON0183 Explanation User Response LCON0184 Explanation User Response Copyright 2004 EVENTS WTOS WTORS TIME This is a heading line for message LOCO982 None This message produced by the STATUS command XXXXXXXX yyyyyyyy ZZZZZZZZ This message follows LCON981 which provides headings Xxxxxxxx is the status of WTO event processing by LOCOMAIN ACTIVE indicates WTO events are being processed it is set by ACTIVATE WTO PAUSED indicates WTO events are not being processed it is set by DEACTIVATE WTO yyyyyyyy is the status of WTOR event processing by LOCOMAIN ACTIVE indicates WTOR events are being processed it is set by ACTIVATE WTOR PAUSED indicates WTOR events are not being processed is set by DEACTIVATE WTOR yyyyyyyy is the status of TIME event processing by LOCOMAIN
195. n User Response LCON0953E Explanation User Response LCON0954E Explanation User Response Copyright 2004 MEMBERS LEFT IN PENDING DELETE STATE The members was left in a pending delete state because of an internal error Contact NETEC technical support IHE LRECL OF THE INDD DATASET MUST BE 80 The logical record length of the dataset specified either by INDD or INDSN on the IMPORT control card is not 80 Correct the error and submit the job for execution MEMBER KEYWORD IS INVALID FOR SEQUENTIAL Ihe MEMBER keyword was found on a LOCO NPUT import export utility IMPORT control card when the INDD or INDSN indicated a sequential data set In this situation the sequential input must contain ADD and REPL control cards Correct the error and submit the job for execution NEW MEMBER NAME NOT ALLOWED WHEN GENERIC MEMBER NAME SPECIFIED Ihe MEMBER KEYWORD of a LOCO IMPORT contains a generic member name The new member name has been specified The new member name cannot be specified when the member name is generic Correct the error and submit the job for execution ADDED ALIAS aaaaaaaa Dos m This is an information message indicating the alias has been added or replaced N
196. n displays current vital statistics about the active LOCO subsystem The following describes the fields on the LOCO status display LOCO Ver Information gt This information represents the current LOCO version release date and time This is the dataset LOCO will load the LOCO tables from This is the currently active LOCO table LOCO Table Dataset ll ll V Active Table ll ll V Proprietary Product of NETEC International Inc Copyright 2004 Page 110 Logical Console Operator User Manual LOCO Submi t Dataset Action Stat WTO WTOR TIME EVENTS CUS Slots Status Slots Used Total Slots Total Msgs Lost The last activity was Message Counts WTO WTOR Commands Actions Replies ABENDS Re issued WTOs This is Thi act HELD ac triggering event Sta ta ta ta S S S T S messages away for processing 11 12 05 the dataset LOCO will use to submit batch jobs from S section indicates whether ions from a queue are ACTIVE or If the actions are held LOCO tions will be bypassed if a occurs tus of WTO actions tus of WTOR actions tus of Time actions tus of Event actions his section contains the status of torage reserved for LOCO to save Each slot represents one message This value represen mark of slots used ts the high water during the current ex Th sl LO O
197. name See LCON USERS GUIDE for more information on running multiple LCON subsystems Proprietary Product of NETEC International Inc Page 173 Logical Console Operator User Manual 11 12 05 LCON0133 Explanation User Response LCON0134 Explanation User Response LCON0135 Explanation User Response LCON0136 Explanation User Response LCON0137 Explanation User Response LCON0138 Explanation User Response Copyright 2004 xxxx NOT APF AUTHORIZE LOCOMAIN found that it D was not APF authorized was an SVC number provided to obtain APF authorization See the LCON USERS GUI of providing APF authorization to LCON NOT ABLE TO OPEN SUBM I FILE LOCOMAIN attempted to open source library ddname SUBMI JCL for the SUBMI Insure that the definition for the job submissiom T LOCOMAI T D N has a proper D statement XXXX TABLE NOT FOR THI 9 LOCOMAIN found that the or from a LOAD command of a different releas release number Insure that the LOCOBLI RELEASE nor installation procedure in the LCON DE for a complete discussion of methods but the open failed LCON table from the PARM was compiled by LOCOBLDR release number as XXXXCVT RELEASE LOCOMAIN found tha LOCOIN I has a different rel
198. name a b c d The return code is ELELEE Correct the error and submit the job for a ADDED nmmmmmmm REPLACED This is an informational message indicating the member mmmmmmmm has either been added or replaced None MEMBER mmmmmmmm NOT REBT PD gp BECAUSE NO SPACE LEFT IN THE DIRECTORY The member mmmmmmmm has not been added or replaced because there was no space left in the PDS directory Correct the error and submit the job for execution MEMBER NOT AD DED BECAUSE OF O ERROR The member was not added because of an internal Cr EOL Contact NETEC technical s upport MEMBER NOT AD DED BECAUSE DCB NOT OPEN The member was not added because of an internal QIEOI Contact NETEC technical support MEMBER NOT ADDED BECAUSE OF NSUFFICIENT VIRTUAL STORAGE The member was not added because of an internal error Contact NETEC technical support ALIAS NOT ADDED BECAUSE OF INVALID TTR The alias was error Contact NETEC technical not added because of an internal support Proprietary Product of NETEC International Inc Page 202 Logical Console Operator User Manual 11 12 05 LCON0948E Explanation User Response LCON0949E Explanation User Response LCONO0950E Explanation User Response LCON0O951E Explanation User Response LCON0952I Explanatio
199. nation of the Operands may be specified If none are keyed then LOCO will deactivate all four triggering types An LOCO status will show the deactivated triggering activities as PAUSED OPERANI ACTIVATE Command The ACTIVATE command will cause LOCO to resume processing the Specified type of triggering activities Any combination of the Operands may be specified if none are keyed then LOCO will activate all four triggering types An LOCO status will show the activated events as ACTIVE OPERANI Proprietary Product of NETEC International Inc Copyright 2004 Page 100 Logical Console Operator User Manual 11 12 05 HOLD Command The HOLD command will cause LOCO to cease processing time events The time events will not be discarded but will queue up until released by RELEASE The TIME operand must be specified An LOCO status will show the time event as HELD COMMAND OPERANDS RELEASE Command Ihe RELEASE command will cause LOCO to resume processing time events All time events which were queued will be performed immediately An LOCO status will show the time event as ACTIVE COMMAND OPERANDS RESET Command The RESET command will cause every LOCO table entry which is in a state of WAITEXT to terminate the WAITEXT and to be recycled to its original wait condition witho
200. nual 11 12 05 LCON0119 Explanation User Response LCONO120 Explanation User Response LCONO121 Explanation User Response LCONO122 Explanation User Response Copyright 2004 NOT FAMIL AR W IH RE from an ACTION D SERV CE the command was not QUESTE An LCON command was issued from the console or sta DEACTI RESET VATE TRACE STATUS tement in the LCON table but one of LOAD ACTIVATE STOP HELP HOLD RELEASE DUMP ZERO REFRESH TRACE Message LCON179 show the offending command Correc t the LCON command MUST SPEC FY MEMBER OR TABLE An LCON LOAD command was issued from the console or from an LCON ACTI ified by MEMBER XXXXXXXX Or was not ident TABLE XXXXXXXX Correc GUIDE t the LCON command TABLE MEMBER NOT FOUND table specified on the LOCOMAI LOAD command was not found in the P The JCL ddname TABLE Insure Insure that the table name is spel that the library defined by TABLE is the correct LCON table library ON statement but the table lt See the LCON USERS N PARM or in the DS defined by led correctly the JCL ddname and that the requested table has been compiled by LOCOBLDR into that library NVAL D SEGMENT LENGTH The structure of the LCON object tab
201. obtain the required storage for the SSVT control block Attempt error SCSBR LOCOMAIN cal persists to run LOCOMAI RE DON REQUEST TO led IEAVG700 FAI LE D N in a larger region contact NETEC Technical Support broadcast to all active subsystems request If error persists failed Support SCSBR LOCOMAIN cal be broadcast request If error persists DOF REQUEST TO led to all failed Support RESUM LOCOMAI CCCCCCCC none RESUM LOCOMAT mmmnmmmrmm none ING N 2CcCCcCccGec ING N CLONE GETMA N FA LE IEAVG7 con IEAVG700 FAI 00 Lact COMMAND LOCOMAIN was unable for a Attempt to run LOCOMAI cont error clone copy of persists CALLE LOCOMA J for an internal D PROGRAM BLOCK GETMA IN was unable to obtain the required storage control block used by the LCON D LE to request active subsystems D LOAD MEMBER mmmmmmmm COMMAND has resumed the loading of table member that was presiously suspended IEAVG700 to request that WTOs be and the contact NETEC Technical that WTOs not and the NETEC Technical has resumed the processing of command that was previously suspended to obtain the required storage an LCON table entry If N
202. ocate the CAFC control file a b c d The allocation has failed LOCOCAFC Correct the control file name in the LOCO table CAFCCMD command Proprietary Product of NETEC International Inc Page 186 Logical Console Operator User Manual 11 12 05 LCON0709 Explanation Issued by CAFC COMMAND ABORTED This is an information message indicating the previous CAFC command has been aborted LOCOCAFC Determine th error and correct User Respons LCONO710 Explanation Issued by User Response LCONO712 Explanation Issued by User Response LCONO713 Explanation Issued by User Response LCONO714 Explanation Issued by User Response LCON0715 Explanation Issued by User Response Copyright 2004 original UNABLE TO LOAD CAFC PROGRAM AFCP2016 The LOCO CAFC subtask has attempted to load the CAFC batch interface program AFCP2016 AFCP2016 was not found in the STEPLIB concatenation LOCOCAFC Add the library containing the AFCP2016 program to the LOCO STEPLIB concatenation CAFC COMMAND COMPLETED RC xx This is an information message indicating the LOCOCAFC subtask has completed th xecution of a CAFC command with return code xx LOCOCAFC none EXECUTING CAFC COMMAND XXXXXXXX This is an information message indicating the LOCOCAFC subtask is executing command Xxxxxxxx LOCOCAFC none DUE T
203. of time problem you should increase the TI If your site frequently encounters this MEOUT value The Proprietary Product of NETEC International Inc Page 86 Logical Console Operator User Manual 11 12 05 T minutes T TRACE TIMEOUT 00 01 00 considering the Cl description of this paramet File Control timeout TRACE Y internal IMEOUT value is specified by coding the number of hours and seconds to wait for a request to complete Facil request CS as non responsive ity Installat rs that CAFC wait 1 minute before For a complete the CICS Application ion Manual value is 2 minutes will cause trace while paramet determine by checking LOCOMAI the CAFCCMD executing N ac IME tivi LOCOMAI Before at ty N checks specified in AFCT2016 without finding an avai interval r overrides task will defaul task the default to see if If this parame to the c via enqueues program waits for an the list following format ue val is tempting to establ lable n 00 2 minutes interval at run keyword on description of File Control After LOCO reaches th finding an available LU name frequency va searches through the lis frequency value frequency val LUMSG 99 the CAFCCM this paramet
204. one NVALID COMMAND IN PREVIOUS CONTROL CARD The LOCO import export utility has found an invalid control card in the previous statement Correct execution Proprietary Product of NETEC International Inc control card the control card and submit the job for Page 196 Logical Console Operator User Manual 11 12 05 LCON09071 Explanation User Response LCONO 909E Explanation User Response LCONO910E Explanation User Response LCONO911E Explanation User Response LCON0913E Explanation User Response LCON0914E Explanation User Response LCON0915E Explanation User Response Copyright 2004 COMMAND COMPLETE RC This is an informati previous LOCO import completed with the r If RC 00 then the co If RC not equal 00 i failed PARSE ERROR IN PREV XX onal message indicating the export utility command has eturn code XX mmand completed successfully nvestigate why the command OUS COMMAND The previous LOCO import export utility control card contains a pars Correct the error an execution e error d submit the job for IHE MEMBER NAME SPECIFIED S INVALID The member name specified on the LOCO utility import export utility control card is invalid Correct the error and submit the job for execution NVALID REPLACE OPTION ON THE MEMBER KEYWORD
205. one s ADDED ALIAS aaaaaaaa NOT REPLACED BECAUSE NO SPACE LEFT IN THE DIRECTORY The alias name has not been added or replaced because there is no space left in the PDS directory None ALIAS NOT ADDED BECAUSE OF I O ERROR The alias was not added because of an internal error Contact NETEC technical support Proprietary Product of NETEC International Inc Page 203 Logical Console Operator User Manual 11 12 05 LCON0955E Explanation User Response LCON0956E Explanation User Response LCON0957E Explanation User Response LCON0958E Explanation User Response LCON0959E Explanation User Response LCONO960E Explanation User Response LCON0961E Explanation User Response Copyright 2004 ALIAS NOT ADDED BECAUSE DCB NOT OPEN The alias was not added because of an internal error Contact NETEC technical support ALIAS NOT ADDED BECAUSE OF INSUFFICIENT VIRTUAL STORAGE The alias was not added because of an internal error Contact NETEC technical support ALIAS NOT ADDED BECAUSE OF INVALID TTR The alias was not added because of an internal error Contact NETEC technical support ALIAS LEFT IN PENDING DELETE STATE The alias was left in a pending delete state because of an internal error Contact NETEC technical support
206. onnecting to LOCO subsystem LOCA The RACF commands necessary to define these profiles are RDEFINE FACILITY LOCO TABLES BROWSE UACC NONE RDEFINE FACILITy LOCO LOCA TABLES EDIT UACC NONE Permission to manipulate LOCO queues LOCO ssss QUEUES qqqqqqq xxxxxxxx ssss Subsystem Name qqqqqqq Queue Nam WTO WTOR TIME STARTUP SHUTDOWN COMMAND Proprietary Product of NETEC International Inc Copyright 2004 Page 148 Logical Console Operator User Manual 11 12 05 EVENT XXXXXXXX Action type BROWSE User can browse the LOCO queue HOLD User can Hold and Release items in the LOCO queue DELETE User can delete items from the LOCO Queue EXECUTE User can execute commands from the LOCO command queue display Example LOCO QUEUES WTO BROWSE Generic profile that will match any request to access any LOCO subsystem Users permitted with READ access to this browse the WTO queuefor any LOCO TSO interface connecting to any LOCO subsystem LOCO LOCA QUEUES COMMANDS DELETE Specific profile that will match users who are trying to access the LOCO subsystem named LOCA Users permitted with READ access to this profile will be able to delete commands from the LOCO command queue through the LOCO TSO interface connecting to LOCO subsystem LOCA
207. onsole Operator User Manual 11 12 05 ACTIONS WAIT indicates to wait for a response NOWAIT specifies to continue without waiting for command completion The default value is NOWAIT WAITTIME This field contains the time to wait for a command to complete if RESPONSE WAIT is specified The default value is 2 minutes SUFFIX This field contains the suffix for the DFSPZP module to use when connecting to DB Control The default value is 00 Proprietary Product of NETEC International Inc Copyright 2004 Page 92 Logical Console Operator User Manual 11 12 05 Compressing LOCO Table and Submit Libraries To prevent the possibility of compressing an LOAD command or LOCOBL DR process is ac the tab tive e all use LOCO table library and LOCO submit subsystem is protec ues ternal batch job any table member co th unknown but pot technig ex wi A compress of the table library utilizing IEBCOPY uld readily produce a damaged table load by tentially disastrous resul while LOCOMAIN is N library while of the through the LOCO ted via operating system serializatio library performed by an n loading ts If you compress the LOCO table library while LOCOMAI utilize the internal LOCO COMPRESS Likewise ex submit but po LOCO s in Co
208. ou wish to terminate NCCF NCCF requires a reply of CLOSE IMMED but the reply cannot be specified directly because you do not know the reply number in advance LOCO can obtain and maintain the latest reply number for NCCF Ihe LOCO control statement below saves the most recent outstanding reply number for NCCF WTOR DSI802A NCCF REPLY SET SR 9 Since it is possible that NCCF could already be running and have already issued its WTOR at the time LOCO is started its prudent to ask LOCO to automatically prime the reply Svar for currently existing WTORs at each and every LOCO s startup The following LOCO control statement will accomplish this PRIME DSI802A NCCF REPLY SET SR49 The PRIME statement is activated 1 at every LOCO startup and 2 whenever a new LOCO control table is LOADED The following ACTION as a part of your shutdown ACTIONs will gracefully terminate NCCF ACTION R R 9 CLOSE IMMED At the time the above ACTION is issued the reply Svar SR 9 will be replaced with the current four digit reply number Proprietary Product of NETEC International Inc Copyright 2004 Page 156 Logical Console Operator User Manual 11 12 05 Utilizing LOCO to initiate CAFC or DBCTL events LOCO can be used to initiate Cl CS Application File Control CAFC or DB Control DBCTL events either based on time of
209. ound to be null Provide some text to make the message mor meaningful to the recipient Proprietary Product of NETEC International Inc Page 164 Logical Console Operator User Manual 11 12 05 LCON0037 Explanation User Response LCON0038 Explanation User response LCON0039 Explanation User response EXPECTED USER SVARIABLE AS TARGET represent receive th Provide a In a SET operand the first characters must the label of the target Svariable to desired string target Svariable in the SET operand EXPECTED SYMBOL MMED ATELY AFTER SVARIABLE be followed by an UV 23 xxxyyy Provide an symbol right portion of the symbol TARGET In a SET operand the target S variable label must Examp SET it is generally in the upper keyboard REPLY SVARIABLE MUST In a SET operand for data was found The SR nn STAND ALONE a reply variable extraneous required syntax is SET Provide a correct syntax for the SET operand LCON0040 ACTION TOO LONG MAX LENGTH IS 120 Explanation ACTION text was found to be bytes User Respons Reduce the length of the ACTION text LCONO041 Explanation User Response LCON0042 Explanation User Response LCON0043 Explanation User Response LCON0044 Explanation User Response Copyright 2004 EVENT NAME UNKNOW
210. pression subtask is beginning termination LOCOCPRS none LIBRARY COMPRESSION SUBTASK INITIALIZATION COMPLETE This is an information message indicating the library compression subtask has completed initialization LOCOALOG none LIBRARY COMPRESSION SUBTASK TERMINATION COMPLETE This is an information message indicating the library compression subtask has completed termination LOCOCPRS none Proprietary Product of NETEC International Inc Page 190 Logical Console Operator User Manual 11 12 05 LCON0748 Explanation Issued by User Response LCON0749 Explanation Issued by User Response LCON0752 Explanation Issued by User Response LCON0753 Explanation Issued by User Response LCONO760 Explanation Issued by User Response LCONO761 Explanation Issued by User Response LCONO0763 Explanation Issued by User Response Copyright 2004 LIBRARY COMPRESSION SUBTASK DEALLOCATION ERROR This is an information message indicating the library compression subtask has encountered an error while attempting to allocate or de allocate the library to compress LOCOCPRS Correct the reason the library could not be allocated or de allocated DYNAMIC ALLOCATION LIBRARY COMPRESSION ABORTED This is an information message indicatin
211. pyright 2004 a compress of the submit ternal batch job utilizing ting a batch job or while a JCL member could produce a damaged submit tential command library performed by N is runnin ly disastrous results ubmit ternal LOCO COMPRESS command library while LOCOMAI IEBCOPY the TSO while the LOCOMAT SPF interface is saving N library with If you need to compress the N is running utilize t Proprietary Product of NETEC International Inc need to g an is unknown he Page 93 Logical Console Operator User Manual 11 12 05 Pseudo WTO Facility LOCO has a facility to produce pseudo WTOs which will interact with LOCOMAIN as if they were real WTOs The pseudo WTOs are created from parm or card image input to program LOCOINTF By including program LOCOINTF as a conditional job step in your production job streams it is easy to produce standardized messages instructing operations personnel to notify the responsible programmers Then whenever application responsibility or programming personnel changes occur a simple update to the LOCO control messages Suppose that programmer many payroll job streams conditional job step perhaps in multipl TELLDON EXEC PGM LOCO table will correct all notify Don Tell is responsible for all of the
212. re the LOCO library exact format PF PF PF PF PF gig gps APF The following example is a parti PROGxx member with APF APF APF APF APF APF Method 2 FO AD AD AD AD AD the current authorized the PROGxx member of The following examp le APF portion of a PROGxx has been added The of the APF card should be verified in the Initialization and Tuning Guide for the MVS version that is executing in your instal RMAT DYNAMIC D DSNAME SYS1 SERBLINK VO D DSNAME SYS1 CSSLIB VO D DSNAME IGY210 SIGYCOMP VOL D DSNAME FAN130 SEAGALT VO D DSNAME DIT130 SDITMOD1 VO lation UME Z1RES2 UME Z1RES1 UME Z1RES2 UME Z1RES2 UME Z1RES1 al listing of the sa the LOCO library added FORMAT DYNAMIC ADD DSNAME SYS1 SERBLINK VOLUME Z1RES2 ADD DSNAME SYS1 CSSLIB VOLUME Z1RES1 ADD DSNAME IGY210 SIGYCOMP VOLUME ZIRES2 ADD DSNAME DIT130 SDITMOD1 VOLUME ZIRES1 ADD DSNAME your load pds SMS Addition Installation of the LOCO authorization SVC The second n is by instal you have a previous version of LOCO currently installed this step may be bypassed because the SVC has not been changed and does not require refreshing The SVC is shipped in you load pds as member LOCOSVC The LOCOSVC member must be copied to a library that is cataloged in the MVS mast
213. reams Ihe SYSPRINT s ment defin for submission by tatement is s the PDS containing job the 8 SUBMIT command used for tracing and debugging as directed by NETEC Your loco job stream library may be any source library containing job streams EOF card to terminate th LOCO explicitly provides a e job stream The submit JCL may not specify a concatenation of data sets only a single data set Your Locorcritical fti requires the following DCB paramters RECFM FA and BLKSIZE 121 f SIMULATE is included in the EXEC PARM LOCOMAIN will print all actions on the SIMULATE data set rather than issuing commands to MVS If REPORT is included in the EXEC PARM LOCOMAIN will create a formatted report of the specified LOCO control table on the REPORT data set and will terminate ACTIONS Either a date must be specified by da HI No be executed DATE mm dd yyyy or a from the LOCO control table will te range must be specified by LODATE mm dd yyyy and DATE mm dd yyyy in the time initiated actions as they would occur for the PARM LOCOMAIN will report the given date range along with all other actions and filter conditions If NORE SSUE is included in the EXEC PARM LOCOMAIN will ignore WTOs and WTORs which are reissued by XCF in a sysplex environment A count of ignored messages
214. rect that prob this table is 16K why so little CSA is Lem available and Proprietary Product of NETEC International Inc Page 168 Logical Console Operator User Manual 11 12 05 LCON0109 Explanation User Response LCONO110 Explanation User Response LCONO111 Explanation User Response LCONO112 Explanation User Response LCONO113 Explanation User Response Copyright 2004 SUPPRESS REROUTE TABLE EXCEEDED 16000 BYTES The suppress reroute table is constructed in a 16000 byte area in the LOCOMAIN address space The number of suppress reroute statements has exceeded this size It requires a very large number of suppress reroute statements to exceed 16000 bytes If you have less than 100 LCON statements with SUPPRESS or REROUTE operands then LOCOMAIN has experienced some internal error If you have 100 or more SUPPRESS or REROUTE operands then you probably have legitimately exceeded th 16000 bytes If the message seems inappropriate or if you would like to have a special version of LOCOMAIN with a larger suppress reroute table contact NETEC Technical Support EXPECTED NEW OTABLE COMMAND The structure of the LCON object table is incorrect The object table may have been damaged after compilation or LOCOBLDR may have created it in error Recompile the LCON table with LOCOBLDR if the same error occu
215. required to execute this queue entry be meet Proprietary Product of NETEC International Inc Copyright 2004 Page 134 Logical Console Operator User Manual 11 12 05 Release the WTOR queue en action should actions req try entry be meet Delete this WTOR queue en entry from the WTOR queue queue will require the LOCO tabl Security Requirements To manipulate these resources requires READ following LOCO LOCO LOCO LOCO XXXX Copyright 2004 try Release LOCO to take uired to execute this queue LOCO will remove the To replace th ntry in the SAF Profiles XXXX SSI XXXX QUEUES WTOR BROWSE XXXX QUEUES WTOR HOLD XXXX QUEUES WTOR DELETE subsys to dis to HOL entrie to DEL be reloaded access to the to access the LOCO tem play queue entries D RELEASE queue Ss ETE queue entries The one to four character LOCO subsytem name Proprietary Product of NETEC International Inc Page 135 Logical Console Operator User Manual 11 12 05 Displaying and Manipulating the STARTUP Queue The following screen is displayed when the user selects the STARTUP queue for manipulation 3 CDDF5100_MANUAL EXTRA Personal I Client File Edit View Tools Session Options Help eastern Logical Console Operator TSO Operator Interface Display Manipulate Startup Queue for LOCA Command gt _ Scrol
216. rmed on or HITIME and LOTIME may define a time range the cpu is a filter key ticular cpu At least on The CPUID valu OWN e ACTION t may contain global e word CO is e may The Filter condition may the cpu id value by th D CPUA HH MM SS and repre keyword SHUTDOWN after that particu en sents a actions lar time Proprietary Product of NETEC International Inc HH MM SS and represents a keyword SHUTDOWN before that particular actions be specified together to Page 61 Logical Console Operator User Manual 11 12 05 DATE LODATE HIDATE WEEKDAY The dat MM DD Y will onl e must follow the exact format of MM DD YY or YYY It is a filter keyword SHUTDOWN actions The dat MM DD Y will onl y be performed on that particular date e must follow the exact format of MM DD YY or YYY It is a filter keyword SHUTDOWN actions y be performed on or after that particular date The dat MM DD Y will on date Note The str the wee keyword weekday Example of MM DD YY or SHUTDOWN actions that particular e must follow the exact format YYY It is a filter keyword ly be performed on or before HIDATE and LODATE may be specified together but DATE may not be specified with either of them If any of the above dat
217. rror while attempting to write to a CRITICAL DDNAME LOCOMAIN is terminated Contact NETEC technical support REGISTRATION WITH THE AUTOMATIC RESTART MANAGER HAS FAILED RC XXXXXXXX RS XXXXXXXX LOCOMAIN has encountered an error while attempting to register with the MVS automatic restart manager Investigate the return and reason codes in the message CURRENT QLIMIT WOULD UTII HAS BEEN RESET TO XXXX LOCOMAIN has encountered an error while processing the load of a table LOCO has determined that the QLIMIT specified in the table would use an excessive amout of MVS CSA LOC has automatically reset the OLIMIT to a more reasonable value Adjust the QLIMIT in the LOCO table ZE EXCESSIVE CSA QLIMIT WAITING FOR ACTIVE CAFC SUBTASK TO COMPLETE LOCO has been ask to terminate and the CAFC subtask is busy processing a CAFCCMD command LOCO will wait until the CAFCCMD command is complete None DUMP REQUESTED LCON has detected an internal error and is producing a memory dump with USER ABEND code 1 If the additional error messages provide a reasonable explanation of the error proceed with the suggested actions associated with those messages Otherwise contact NETEC Technical Support at your earliest convenience REISSUED WTOS IG
218. rs contact NETEC Technical Support NVALID TABLE RECORD TYPE The structure of the LCON object table is incorrect The object table may have been damaged after compilation or LOCOBLDR may have created it in error Insure that the release levels of LOCOBLDR and LOCOMAIN are the sam Recompile the LCON table with LOCOBLDR if the error persists contact NETEC Technical Support QUEUE CHAIN ERROR LOCOMAIN attempted to remove an Statement from one of the event not find the statement Contact NETEC Technical Support LCON table queues but could WAIT POST ERROR LOCOMAIN was dispatched after a WAIT was set to X 40 Contact NETEC Technical Support but no ECB Proprietary Product of NETEC International Inc Page 169 Logical Console Operator User Manual 11 12 05 LCONO114 Explanation User Response LCONO115 Explanation User Response LCON0116 Explanation User Response LCONO117 Explanation User Response LCON0118 Explanation User Response Copyright 2004 SP Th QT li In In TA th in ECIFIED TABLE NOT FOUND e LCON table specified in the PARM or in the OAD command was not found in the LCON table brary defined by JCL ddname TABLE sure that the table name is spelled correctly sure that the library defined by the JCL ddname BLE is the correct LCON table library and that e
219. s indicate missing lines of information that have been removed to shorten the listing J RRR RRR KKK KK KK RK I KCKCK I I kkk k kc k Ck kck ck kck ck kck ck kkk k kk k k K LI LIE ISPF FULL FUNCTION LOGON PROC a J RRR RRR KKK KK KK RK I I I I kCk CK k kc k k kc k ck OK ckckck ck kk ISPFPROC EXEC PGM IKJEFTO1 REGION 0M DYNAMNBR 175 PARM SISPFCL SYSUADS DD DISP SHR DSN SYS1 UADS SYSLBC DD DISP SHR DSN SYS1 BRODCAST SYSPROC DD DISP SHR DSN SYS1 LOCAL CLIST DD DISP SHR DSN ISP SISPCLIB SYSEXEC DD DISP SHR DSN ISP SISPEXEC DD DISP SHR DSN SOMMVS SGOSREXX SYSHELP DD DISP SHR DSN SYS1 HELP Lf DD DISP SHR DSN ISP SISPHELP ISPMLIB DD DIS DD DIS HR DSN ISP SISPMENU HR DSN SYS1 DFOMLIB ISPEXEC DD DIS P SHR DSN ISP SISPEXEC DD DISP SHR DSN SYS1 SBPXEXEC ISPLLIB DD DISP SHR DSN GDDM SADMMOD ISPPLIB DD DISE P SHR DSN SYS1 LOCAL ISPFPNLS DD DISP SHR DSN ISP SISPPENU Py DD DISP SHR DSN SYS1 DFQPLIB ISPSLIB DD DIS DD DIS HR DSN ISP SISPSLIB UNIT 3390 VOL SER Z1RES1 HR DSN GIM SGIMSENU UNIT 3390 VOL SER Z1RES1 ISPTLIB DD DIS DD DIS SHR DSN ISP SISPTENU UNIT 3390 VOL SER Z1RES1 SHR DSN SYS1 DGTTLIB UNIT 3390 VOL SER Z1RES1 Proprietary Product of NETEC International Inc
220. s In addition LOCO will automatically log your master console onto each TP region that can accept MVS modify commands With these standard techniques your LOCO actions can utilize WTOR responses or modify commands to communicate with TP components Proprietary Product of NETEC International Inc Copyright 2004 Page 94 Logical Console Operator User Manual 11 12 05 In a production environment with or without an automated scheduling system additional job steps are simply added to job streams and condi tionally executed or bypassed Applications include closing and free ing needed files changing file status to read only disabling transa ctions during batch updates closing opening data bases and placing terminals on or off line The Pseudo WTO facility is invaluable in shut down procedures for on line systems and networks Inserting LOCO Psuedo WTOs in Batch Job Streams The LOCOINTF program can be run as a conditional jobstep within your jobstreams to issue psuedo WTOs to LOCOMAIN f a single psuedo WTO is to issued it can be specified in the PARM if multiple psuedo WTOs are to be issued they are provided as SYSIN data Example 1 TELLOCO1 EXEC PGM LOCOINTF PARM SSN xxxx MSG PAYROLL STEP 3 FAILED COND O GT STEP3 Corresponding LOCO table statements might be WTO PAYROLL STEP FAILED A
221. s a clock value It is a filter keyword WTO actions will only be performed on or before that particular time of day Note HITIME and LOTIME may be specified together to define a time range The date must follow the exact format of MM DD YY or MM DD YYYY It is a filter keyword WTO actions will ly be performed on that particular date e date must follow the exact format of MM DD YY or DD YYYY It is a filter keyword WTO actions will ly be performed on or after that particular date date must follow the exact format of MM DD YY or DD YYYY It is a filter keyword WTO actions will only be performed on or before that particular date NO Proprietary Product of NETEC International Inc Page 69 Logical Console Operator User Manual 11 12 05 WEEKDAY Note HIDATE and LODATE may be specified together but DATE may not be specified with either of them If any of the above date operands is specified as MM DD YY LOCO will provide the complete YYYY internally If YY is in the range of 00 through 50 then the century will be set to 20 if YY is higher than 50 then the century will be set to 19 The string of characters represents the seven days of the week beginning with Monday It is a filter keyword The WTO actions will NOT be performed on weekday positions which contain a period Example WEEKDAY
222. s each LOCO command This document will use the default value of The LOCO commands are keyed on the MVS console The general syntax for LOCO commands is a command verb followed by none or more operands The operands may be separated from the verb and from each other by a comma or by blanks COMMAND PURPOSE HELP display list of LOCO commands on console gt submit job stream through JES internal reader STOP terminate LOCO execution STATUS display information about LOCO on console LOAD change to a new control table DEACTIVATE temporarily stop LOCO functions ACTIVATE continue LOCO functions HOLD suspend LOCO time based functions RELEASE resume LOCO time based functions RESET recycle all table entries WAITing TEXT set LOCO statistical counters to zero write a message to the console send a message to a TSO user print a message to SYSPRINT write a message to CRITICAL file call user written exit program REFRESH load new copy of exit program Proprietary Product of NETEC International Inc Copyright 2004 Page 97 Logical Console Operator User Manual 11 12 05 QHELP Command The HELP command will list the LOCO commands on the MVS console There are no operands COMMAND OPERANDS gt Command The SUBMIT command will select a JCL job stream from the LOCO job library and submit it through the JES
223. ser var preceding the symbol Copyright 2004 Proprietary Product of NETEC International Inc Page 60 Logical Console Operator User Manual 11 12 05 SHUTDOWN Statement This statement delineat performed by LOCO as it ACTION CPUID LOTIME an action or series of actions to be ACTION text CPUID cccc LOTIME time HITIME time DATE date LODATE date HIDATE date WEEKDAY m WAITIME 1 twtfss time WAITEXT text RESET time SET UV nn text S terminates execution required optional option option option option option option option option option option The text is one of two types of commands 1 an MVS command 2 a LOCO built in command The ACTION keyword may be repeated on the SHUTD Statement as many times as needed The ACT Svars for real time subst The cpuid is a four digit internal MVS id of SHUTDOWN actions will only be performed when LO must be coded t value representing th invoked on that par contain wildcard characters be reversed by preceding minus symbol The time is in clock value of day Copyright 2004 The time is in clock value time of day Note E G CPUL the format It is a fil will only be performed on or the format of It is a filter will only be perfo
224. source like JCL TSO or LOCO the required TCTTE entry is DFHTCT TYPE TERMINAL TRMIDNT xxxx TRMTYPE CONSOLE CONSLID 00 x PX xX The CONSLID must be 00 Before general transactions can be issued to the CICS console terminal a sign on must be issued for a valid user F cicsjobname CSSN NAME name PS password This sign on must have a security level sufficient to issue any further CICS transactions you wish to start on the CICS console terminal CICS can be shutdown with F cicsjobname CEMT S TAS ALL P F cicsjobname CEMT P SHUT The following LOCO table entries will accomplish the sign on automatically and provide a short form command for shutdown WTO DFH1500 CONTROL Proprietary Product of NETEC International Inc Copyright 2004 Page 151 Logical Console Operator User Manual 11 12 05 ACTION F SJOBNAME CSSN NAME name PS password COMMAND SHUT x ACT ION F STEXT 6 8 CEMT S TAS ALL P WA TIME 00 01 00 ACT ION F STEXT 6 8 CEMT P SHUT A shutdown at a certain time of day is similar 19 30 00 ACT ION F cicsjobname CEMT S TAS ALL P WA ACT TIME 00 01 00 ION F cicsjobname CEMT P SHUT Running LOCO before JES LOCO may be started directly from COMMNDOO member of SYS1 PARMLIB and then used to start JES reply to JES and start other
225. sponse LCON0192 Explanation User Response Copyright 2004 LAST ACTIVITY AT hh mm ss XXXXXXXXXXXXXXXXXXXXXXXXXXXX The last ACTION performed by LCON was XXXXXXXXXXXXXXXX at time of day hh mm ss None This message produced by the Q8 STATUS command WTORS SEEN XXXXXX The number of WTOR events seen by LOCOMAIN is XXXXXX None This message produced by the STATUS command WTOS SEEN XXXXXX The number of WTO events seen by LOCOMAIN is XXXXXX None This message produced by the STATUS command COMMANDS SEEN XXXXXX The number of LCON commands seen by LOCOMAIN is XXXXXX None This message produced by the Q8 STATUS command ACTIONS TAKEN XXXXXX Ihe number of LCON ACTIONs processed by LOCOMAIN is XXXXXX None This message produced by the Q8 STATUS command REPLYS GIVEN XXXXXX The number of REPLYS issued by LOCOMAIN is Xxxxxx None This message produced by the STATUS command OK Okay None gt XXXXXXXXXXXX This message is preceded by LCON993 is an available LCON console command None This message is produced in response to HELP XXXXXXXXXX Proprietary Product of NETEC International Inc Page 182 Logical Console Operator User Manual 11 12 05 LCON0193 Explanation User Response LCON0194 Explanation User Response LCON0195 Explanation User Response LCON0196 Explanation User Response LCON0197 Explana
226. sued the triggering activity SJOBID This value is set to the JES jobid of the job task or TSO user which issued the triggering activity The JOBID will begin with JOB STC or TSU followed by a 5 digit number STSOID This value is set to the TSO user id who submitted the job which issued the activity which triggered the ACTION SORIGIN This value is set to the JES sysid field CTXTSYSN of the system which issued the WTO R which triggered the ACTION SEXITEXT This character string is set by User Exit programs See SPECIAL TECHNIQUES section on EXIT PROGRAMS for details The following table depicts which Svariables can participate in ACTIONS for specific LOCO control Table statements SVariable TOD WTO WTOR PRIME COMMAND EVENT STARTUP MAJOR SHUTDOWN STIME X X X X X X X SDATE X X X X X X X SDATE2 X X X X X X X SDATE3 X X X X X X X SDATE4 X X X X X X X DATE5 X X X X X X X SDATE6 X X X X X X X Proprietary Product of NETEC International Inc Copyright 2004 Page 54 Logical Console Operator User Manual 11 12 05 SWEEKDAY SCPUID SUV nn SR nn SEXITEXT STEXT SMINOR SJOBNAME SSTEPNAME SJOBID STSOID SORIGIN xx PX PX PX xxx PX PX xxx PX PX xx PX PX PX xx PX PX PX PX xx PX PX PX PX Xx XM PX PX 0X 0X OX x PX PX PX x X X K XxX X K X X Proprietary Product of NETEC International Inc Copyright 2004 Page 55 Logical Console Operator User Manual 11 12 05
227. ter to the HIDATE parameter The results of the execution are output to REPORT ddname No real actions are taken during a report mode execution When LOCO is executing in simulate mode LOCOMAIN will process the LOCO table specified by the MEMBER parameter value in real time The results of the execution are output to the SIMULATE ddname No real actions are taken during a simulate mode execution Both simulate and report modes of execution are useful when validating new tables before that are placed into production The following JCL will execute LOCO in report mode LOCOMAIN JOB m LOCO EXEC PGM LOCOMAIN DPRTY 15 15 PERFORM 9 TIME 1440 REGION 1024K PARM MEMBER tabname SSN xxxx REPORT DATE 01 01 2004 STEPLIB DD DSN your loco loadlib DISP SHR DD DSN your CAFC loadlib DISP SHR Optional 3 DD DSN your DBCT loadlib DISP SHR Optional TABLE DD DSN your loco table library DISP SHR SUBMIT DD DSN your loco job stream library DISP SHR CRITICAL DD DSN your loco critical file DISP SHR DCB BUFNO 1 CRITCALI DD DSN your loco critical filel DISP
228. therparms 7 STEPLIB DD DSN your loco loadlib DISP SHR DD DSN your CAFC loadlib DISP SHR optional DD DSN your DBCT loadlib DISP SHR optional TABLE DD DSN your loco table library DISP SHR SUBMIT DD DSN your loco job stream library DISP SHR CRITICAL DD DSN your loco critical file DISP SHR DCB BUFNO 1 CRITCALI DD DSN your loco critical filel DISP SHR DCB BUFNO 1 CRITCAL2 DD DSN your loco critical file2 DISP SHR DCB BUFNO 1 CRITCAL3 DD DSN your loco critical file3 DISP SHR DCB BUFNO 1 P ou INTRDR DD SYSOUT A INTRDR DCB BLKSIZE 80 SYSPRINT DD SYSOUT SIMULATE DD SYSOUT REPORT DD SYSOUT SYSABEND DD SYSOUT ALOGSUBT DD SYSOUT CAFCSUBT DD SYSOUT DBCTSUBRT DD SYSOUT LOCOALOG DD SYSOUT NOTES 1 The DPRTY and PERFORM keywords should be set to the same values you have on your JES proc The ffectiveness of LOCO is somewhat diminished if it runs at a low priority 2 Tabname in the PARM is the initial LOCO control table for LOCOMAIN to use and xxxx is the LOCO subsystem name you have chosen 3 Ihe STEPLIB statement is not necessary if LOCOMAIN resides in an APF authorized LNKLST library Proprietary Product of NETEC International Inc Copyright 2004 Page 43 Logical Console Operator User Manual 11 12 05 10 T3862 The TABLE statement defines th P DS containing the LOCO object control tables The SUBMIT stat st
229. this profile will be able to submit jobs from the LOCO submit library through the LOCO TSO interface connecting to LOCO subsystem LOCA The RACF commands necessary to define these profiles are RDEFINE FACILITY LOCO SUBMIT BROWSE UACC NONE RDEFINE FACILITy LOCO LOCA SUBMIT SUBMIT UACC NONE Permission to manipulate LOCO tables LOCO ssss TABLES XXXXXX ssss Subsystem Name Proprietary Product of NETEC International Inc Copyright 2004 Page 147 Logical Console Operator User Manual 11 12 05 BROWSE User can browse LOCO tables EDIT User can edit LOCO tables LOAD User can reload LOCO tables IMPORT User can import table source into the LOCO table library EXPORT User can export table source from the LOCO table library Example LOCO TABLES BROWSE Generic profile that will match any request to access any LOCO subsystem Users permitted with READ access to this profile will be able to browse LOCO tables found in the LOCO table library of any LOCO TSO interface connecting to any LOCO subsystem LOCO LOCA TABLES EDII Specific profile that will match users who are trying to access the LOCO subsystem named LOCA Users permitted with READ access to this profile will be able to edit LOCO tables from the LOCO table library through the LOCO TSO interface c
230. ting the LOCO table x m m S GS GS CS G3 C3 C2 C2 C2 ck COD 170001 WAITTIME 00 01 00 180001 ACTION K A NONE L 01 190001 WAITEXTCHAITTEXT 200001 RESET 02 00 00 210001 ACTION K A NONE L 02 1 00 1 83 19 Connected to host 10 1 1 20 12 00 PM The user can specify one of four options from this menu The user can either 1 Press ENTER to confirm the replacement of the table that has just been edited and recompiled 2 Enter the CREATE command to have a new table member created in the LOCO table library 3 Enter the REPLACE command to replace an existing table member in the LOCO table library 4 Enter END EXIT or PF3 to terminate the table edit without saving the modified table The ISPF statistics will be updated as part of the table save process Proprietary Product of NETEC International Inc Copyright 2004 Page 118 Logical Console Operator User Manual 11 12 05 Loading a LOCO Table By entering an L in front of a member name in the manipulate LOCO tables member name list and pressing enter a new copy of the selected LOCO table will be loaded by the LOCO subsystem The following example shows the LOCO table TESTTABL being reloaded Z CDDF5100_MANUAL EXTRA Personal Client E la xl File Edit View Tools Session Options Help LOCO TABLE DSNAME NETEC LOCO33 TABLES Row 00001 of 0006 Command gt Scroll gt
231. tion User Response LCON0198 Explanation User Response LCON0199 Explanation User Response Copyright 2004 LCON CONSOLE COMMANDS ARE This message is a heading for messages LCON992 None This message is produced in response to HELP ABENDS RECOVERED 10 MAXIMUM xxxxxx LOCOMAIN has abended xxxxxx times and recovered Ignore unless pervasive then notify NETEC LCON trace may point to problems LCON CALLED PROGRAM PPPPPPPP WAS IN CONTROL LCON user written exit program named PPPPPPPP was in control at the time of an abend Fix user written exit program error EXECUTION ABORTED LCON has detected an internal error and is terminating There should be additional messages describing the error If the additional error messages provide a reasonable explanation of the error proceed with the suggested actions associated with those messages Otherwise contact NETEC Technical Support at your earliest convenience LCON HAS EXPERIENCED AN ABEND The LCON ESTAE exit is in control due to an unexpected condition Save the dump and notify NETEC Technical Support at your earliest convenience LCON IS ATTEMPTING TO WITHDRAW FROM THE SYSTEM The LCON ESTAE exit is in control due to an unexpected condition LOCOMAIN is beginning a controlled shutdown None LCON HAS WITHDRAWN FROM SYSTEM SUCCESSFULLY The LCON ESTAE
232. tion and found DATE sp combination with either LODATE Specify either DATE parm alone LODATE and HIDATE and resubmit NO REPORT DATE SPECIFIED LOCOMAIN received an execution REPORT option and found that no LODATE or DATE parmameters wer time PARM for the ecified in or HIGHDATE or the parm pair of the job time PARM for the ne of HIDATE Provide date parameters and res NO LOW REPORT DATE SPECIFIED LOCOMAIN received an execution REPORT option and found that HI but LODATE was not Provide the low date parameter job NO HIGH REPORT DATE SPECIFIED LOCOMAIN received an execution Specified ubmit the job time PARM for the DATE was specified and resubmit the time PARM for the REPORT option and found that LODATE was specified but HIDATE was not Provide the high date parameter job LODATE HIDATE OUT OF SEQUENCE and resubmit the LOCOMAIN received an execution time PARM for the REPORT option and found the HIDATE and LODATE values were in reverse order Correct the erroneous dates and EXIT PROGRAM HAS NEVER BEEN LOADED resubmit the job LOCOMAIN received a request to REFRESH an exit program but found that the exit been loaded and need not be ref None TIMEOUT DURING SUBTASK ATTACH LOCOMAIN has encountered
233. tions 4 thru 28 or 01 D YY OR MV l the format but it is not to exactly in positions 3 and numeric in the range o 5 must be numeric in thru 31 month XXXXXXXXXXXX NOT ALLOWED D YYYY operand mm dd yy or 8 bytes with 6 Positions f 01 thru 12 the range of 01 as appropriate for the Century portion of YYYY must be 19 or 20 N TH S STA TEMENT The keyword operand XXXXXXXXXXXX May not be used in this LCON s See the LCON USERS GUI tatement combinations for this statement DE for the proper keyword XXXXXXXXXXXX REQU RED N TH S STATEMENT The keyword operand XXXXXXXXXXXX must be used in this LCON stat See the LCON USERS G combinations f ement UII or this statement XXXXX The syntax che LCON statement If errors were the LCON table ERRORS DETECTED IN STATEMENTS cker found xxxxx total S found with LOCOBLDR SORT ERROR LOCOBLDR links There should b pertaining to SYSOUT D Check yo action ur Sor D file DE for the proper keyword errors in the correct them and recompile the your standard sort program e error messages from this error the sort Sort messages go to the messages manual for corrective XXXXXXXXXXXX and yyyyyyyyyyyy ARE MUTUALLY EXCLUSIVE OPERANDS The keyword operand Xxxxxxxxxxxxx and yVyVyVyVyy
234. tions at specific times of the day e Wildcard characters and message text parsing e Multiple actions with conditional waits either for time periods or the occurrence of other events e Easy to use commands to control LOCO s operation e Open architecture with User Exits to implement complex decisions and actions e Job stream submission e Automatic or operator controlled load of new LOCO control tables e Automatic WTO processing with rerouting message suppression non deletion and message expansion e User defined operator commands e Extremely low overhead no I O to access the control tables minimal CSA usage optimized instruction paths for hits and misses e Variable symbols to insert jobname tsoid WTOR reply numbers time and other system generated constants in the ACTION commands e A simulation mode is available which causes LOCO actions to be written to a data set rather than issued as console commands e Seamless interface to other NETEC International products such as CICS Application File Control CAFC and the DBControl batch interface e Secure TSO interface that provides o Online table preparation edit browse reload o Current LOCO status display o Control of LOCO internal trace functions o Request LOCO submit batch jobs from the job submission library o Manipulate the LOCO work queues Individual q
235. ue option CPUID cccc option TSOID ttttttt option ORIGIN value option THRESHOLD count option SLEEP time option WAITIME time option WAITEXT tex option RESET time option SET SUV nn option MINOR The text is matched to the minor data line of the MULTI LINE WTO The text data from the multi line WTO is presented to LOCOMAIN as text pairs with each minor data line paired with the original major line The ACTIONs are invoked only when both MAJOR and MINOR text matches the MLWTO The SVARIABLE STEXT will then contain the major text and SMINOR will contain the minor text for substitution into the ACTIONs MINOR may contain wildcard characters Either MINOR or MINOR4 but not both must be specified MINOR The value is the sequential line number of the MLWTO minor line first minor text line is 1 In many cases minor lines of MLWTOs have no constant data to match Proprietary Product of NETEC International Inc Copyright 2004 Page 68 Logical Console Operator User Manual 11 12 05 ACTION SUPPRESS for triggering actions By specifying MINOR the ACTIONS are triggered when the MAJOR text matches and the MINOR line is present The SVARIABLE STEXT will then contain the major text and SMINOR will contain the minor
236. ueue entries may be held released or deleted Command queue entries may also be executed Proprietary Product of NETEC International Inc Copyright 2004 Page 7 Logical Console Operator User Manual 11 12 05 o Provide control of LOCO internal resources Proprietary Product of NETEC International Inc Copyright 2004 Page 8 Logical Console Operator User Manual 11 12 05 Operational Overview LOCO is driven by tables of triggering events and action statements which reside in a PDS The activity statements are coded in a source language similar in syntax to IDCAMS The source statements are compiled into object tables The table s are loaded into LOCO s private address space and become totally resident There are nine major statements e DEFINE to specify global information of interest to LOCO e STARTUP to specify actions to occur as LOCO begins execution e WTO to specify actions to occur whenever a certain WTO is issued e EVENT to specify actions to occur whenever a certain LOCO defined event occurs e WTOR to specify replies to respond to certain WTORs e to specify actions to e COMMAND to specify ac occur at a certain time of day tions to occur whenever a certain console command is keyed e CAFCCMD to define CAFC commands that can be used as ACTION targets of other LOCO commands e DBCTCMD to define D
237. ut executing any of the following ACTIONs The RESET command may be keyed from the MVS console but its most logical use would be automatic execution at some appropriate time of day from a time entry in the LOCO table Example 23 59 ACTION RESET COMMAND OPERANDS Proprietary Product of NETEC International Inc Copyright 2004 Page 101 Logical Console Operator User Manual 11 12 05 QZERO Command The ZERO command will immediately set all LOCO statistical counters to zero COMMAND OPERANDS Q Command The WTO command may not be keyed on the MVS console It is for use as an ACTION in an LOCO control table It may be used to produce additional explanatory messages for some particular WTO It may be used in addition to a REPLY to produce an audit trail or confirmation of LOCO automatic replies COMMAND OPERANDS message text 00000 The second format allows explicit routing and descriptor codes to be specified The routing codes are keyed as Rn where n ranges from 1 through 128 descriptor codes are keyed similarly as Dn where n ranges from 1 through 16 The actions implied by these codes are described in IBM s manual titled Routing and Descriptor Codes The syntax is e multiple routes and descriptors may be keyed in any order Separated by commas e the list of routing and descriptor codes must
238. v SPACE CYL 5 1 15 RLSE DCB RECFM FB LRECL 80 BLKSIZE 2 3440 SYSUT3 DD UNIT SYSDA SPACE CYL 1 1 SYSUT4 DD UNIT SYSDA SPACE CYL 1 1 SYSIN DD COPY I SYSUT1 O SYSUT2 FILES3 EXEC PGM IEBCOPY SYSPRINT DD SYSOUT SYSUT1 DD DSN LOCO ISPF ISPPLIB DISP OLD UNIT TAPE Je VOL SER xXxXXXX lt insert LOCO tape volser LABEL 3 EXPDT 98000 SYSUT2 DD DSN your ispf ispplib DISP NEW CATLG DELETE UNIT SYSDA Proprietary Product of NETEC International Inc Copyright 2004 Page 16 Logical Console Operator User Manual 11 12 05 VOL SER vvvvvv ef SPACE TRK 5 1 15 RLSE DCB RECFM FB LRECL 80 BLKSIZE 2 3440 SYSUT3 DD UNIT SYSDA SPACE CYL 1 1 SYSUT4 DD UNIT SYSDA SPACE CYL 1 1 SYSIN DD COPY T SYSUT1 O SYSUT2 FILE4 EXEC PGM IEBCOPY SYSPRINT DD SYSOUT SYSUT1 DD DSN LOCO ISPF ISPMLIB DISP OLD UNIT TAPE VOL SER XXXXXX lt insert LOCO tape volser LABEL 4 EXPDT 98000 SYSUT2 DD DSN your ispf ispmlib DISP NEW CATLG DELETE UNIT SYSDA VOL SER vvvvvv SPACE TRK 5 1 15 RLSE DCB RECFM FB LRECL 80 BLKSIZE 8800 SYSUT3 DD UNIT SYSDA SPACE CYL 1 1 SYSUT4 DD UNIT
239. variable substitu is 598 block times the current LOCOMAIN The max variable amount of CSA would be 612352 bytes if the QLIMIT is equal to 1024 time and The variable amount the size of one WTO t number of WTOs waiting for processing by 1024 548 table of statements uted upon the occurrence of pseudo WTO text The actions consist of The execution of as date time by certain variable console command MVS console commands the actions may be jobname The tion from the Proprietary Product of NETEC International Inc Copyright 2004 Page 11 Logical Console Operator User Manual 11 12 05 The so checking for sta urce LOCO LOCOBLDR into ob table statements are compil ject form usable by LOCOMAI completeness of operands operand values ordered for struct lengths for I O environment translated into tokens so that no required in real MISSES All staten and time The heart of LOCO be invoked as a s LOCOMAIN will address space the LOCO tab is placed on a wait and WTOR sta ma in tching text terface LOCO le stal load the specified LOCO con No further tements tement syntax combinator N Led by program module LOCOBLDR performs ial correctness and structure and The statements and operands are organized and ured processing by LOCOMA are minimized even in
240. w OY C2 J C2 Co Ww WO od e D bh D N D WwW od od O1 en Oo Oo O1 N O1 Co O1 Co O1 D O1 D Page 4 Logical Console Operator User Manual Utilizing LOCO to initiate CAFC or DBCTL events BE Ode MessqQges loesdwe wv IRR alte Aye wet ES Wks WORE S eget es Messages from LOCOBLDR LCON0001 LCON0099 Messages from LOCOMAIN LCON0101 LCONO0300 Messages from LOCOINTF LCON0601 LCON0699 Messages from LOCO Subtask LCON0700 LCON0799 Messages from LOCOINIT LCONO800 LCON0899 Messages from LOCOIMEX LCON0900 LCON0999 Proprietary Product of NETEC International Inc Copyright 2004 Date PIES 24S eMe ta DEUM E Rete Jane etna Dots feces NOT CATIGD 2 MESSAGES eo me oma m m m RU Deterred meplly to WIORS soree eet eeu e IE 11 12 05 Vd tepisyete set eue a i o eR eee Slee e ce DO E EE te forse WOO e en Obie a E EL ds dere Ne eee edsaui 919 rcr ee oa LOY Sie oe due do said e ad wus ere gue D OF dsdemoldadive wel uade qu wie LOS iced ane oap eso Page 5 Logical Console Operator User Manual 11 12 05 Introduction LOCO the Logical Console Operator reduces and simplifies people s interactions with MVS JES NCCF VTAM VSAM CICS TSO IMS security packages batch and on line applications and hardware software errors When LOCO detects a system activity triggering event that you consi
241. wo cards Rearrange more than the operand keyword and value so that no two cards are spanned XXXXXXXXXXXX EXCEEDS MAX VALUE FOUND yyyyyyyyyyyy The value yyyyyyyyyyyy for keyword operand XXXXXXXXXXXX is greater than the maximum acceptable value Correct the operand value XXXXXXXXXXXX MUST BE NUMERIC FOUND yyyyyyyyyyyy The value yyyyyyyyyyyy for keyword operand XXXXXXXXXXXX is required to be numeric but it is not Correct the operand value XXXXXXXXXXXX VALUE IS UNKNOWN FOUND yyyyyyyyyyyy The value yyyyyyyyyyyy for keyword operand XXXXXXXXXXXX is not an acceptable value Correct the operand value XXXXXXXXXXXX VALUE IS INCORRECT LENGTH FOUND YYYYYYYYYYYY The value yyyyyyyyyyyy for keyword operand XXXXXXXXXXXX Contains more or less than the required number of bytes Correct the operand value Proprietary Product of NETEC International Inc Page 161 Logical Console Operator User Manual 11 12 05 LCON0018 Explanation User Response LCON0019 Explanation User Response LCONO0020 Explanation User Response LCONO021 Explanation User Response LCON0022 Explanation User Response LCONO0023 Explanation User Response Copyright 2004 XXXXXXXXXXXX MUST BE MM D FOUND yyvyyyYYYYYYY ue yyyyyyyyyyyy for keyword XXXXXXXXXXXX must be in mm dd yyyy exactly Correct the operand value The val the character 1 2 must be Posi
242. word will cause this WTO entry to be dormant for the specified amount of time after it has completed th ntire series of ACTIONS It is effectively removed from the table for the time period The default is taken from the Proprietary Product of NETEC International Inc Page 66 Logical Console Operator User Manual 11 12 05 DEF DEFINEd it WAIT ME WAITEXT RESET SET Copyright 2004 amount of WILDCARD a WTO Note INE SLEEP statement defaults to zero Ihe time is of the format HH MM SS and represents an TIME may be ON causing a wait for that amount of ON time coded after an ACTI time before proceeding to The text is any string of TEXT may be coded after an ACTI text string is issued as a After the text is seen as A WA causing a wait until that WTO through the MVS the next ACTION is performed Both WAITIME ACTIONS be performed is satisfied functionally not a clock value the next A characters A WA If SLEEP is not explicitly CTI incl uding the ON system In operator and WAITEXT may be coded between that case the second ACTION will as soon as EITHER wait condition The wait keywords are connected by a logical OR The time is of the format HH MM SS and represents an A RESET may be amount of time coded only after a WAI
243. yy may not both b See the LCON USERS GUI combinations f Proprietary Prod e or this statement uct of NETEC International Inc used in an LCON statement DE for the proper keyword Page 162 Logical Console Operator User Manual 11 12 05 LCON0025 XXXXXXXXXXXX SPECIFIED TWICE WITHOUT INTERVENING ACTION Explanation WAITIME or WAITEXT may be used only once each User Response LCON0026 Explanation User Response LCON0027 Explanation User Response LCON0028 Explanation User Response LCON0029 Explanation between LCON ACTIONs See the LCON USERS GUIDE for keywordcombinations for this the proper statement XXXXXXXXXXXX CONTAINS INCORRECT ROUTE DESCRIPTOR CODES Route codes may be any value from this list R1 R2 R3 R4 R5 R6 R7 R8 R9 R10 R11 R12 R13 R14 R15 R16 Descriptor codes may be any value from this list Dl D2 D3 D4 D5 D6 D7 D8 D9 D10 D11 D12 D13 D14 D15 D16 The codes may be combined in any commas E G R4 D2 R8 D1 See the LCON USERS GUIDE for specification of route and d UNABLE TO FIND TERMINAT ROUTE DESCRIPTOR CODES The syntax checker failed to list of route descriptor cod be terminated with a right p Correct the route descriptor right parentheses at the end

Translated by WordPort from WordStar 3.x - 7.0 document

Contents

Download Pdf Manuals

Related Search

Related Contents