Home

HOBCOM

1. APPENDIX 5 ENTRY OCCUPIED LA RH4 8 RH4 NEXT ENTRY LA RH2 PEXPOOL2 END OF POOL CLR 4 2 AT END OF POOL BL 02 ON SEARCHING TS 0 RHO SET DISPLAY FLAG BNZ PEXP12 ALREADY SE L R15 SASDISP1 ROUTINE DISPLAY BALR R14 R15 PICK DISPLAY FIELD LTR RSP1 RSP1 SOMETHING TO DISPLAY BZ PEXP12 NO MVC 0 34 RSP1 C XC USER EXIT ALL ENTRIES USED BALR R14 R15 OUTPUT MESSAGE DS WITH ERROR MESSAGE LA R15 ADDRESS ERROR MESSAGE B PEXRERR ERROR JUMP BACK DS ENTRY FROM MVC 8 8 RPARA 0 APPL PASS DS OH BUILD POOL LA PEXPOOL2 PEXPOOL1 4 LENGTH OF POOL LR RSP1 RH3 LENGTH OF STORAGE L R15 SASSTGP ROUTINE STORAGE PERMANENT BALR R14 R15 GET STORAGE LR RH2 RSP1 NEW ADDRESS XR R15 R15 ERASE PAD BYTE MVCL RH2 R14 DELETE STORAGE LA PEXPOOL2 PEXPOOL1 8 OF ENTRIES ST RH3 0 RSP1 SET NUMBER MVC 4 8 RSP1 0 RH4 FIRST ENTRY ST RSP1 SASUPNAT SET INTERIM STORAGE B PEXROK JUMP BACK DS ENLARGE TABLE LH RH3 2 RHO NUMBER OF ELEMENTS LA RH1 8 RH3 ENLARGE LR RH2 IRANSFER NUMBER SEE RH2 3 NUMBER TIMES 8 LA RSP1 4 RH2 GET LENGTH PLUS INTRODUCTION L R15 SASSTGP ROUTINE STORAGE PER
2. PX PX X258L05 LINE LCN 5 EL 5 WITHIN GROUP 8 VCCINFX 1 OUFINDX 1 CALL INOUT TYPE S x258P05 PU PUTYP X258L06 LINE LCN 6 EL 6 WITHIN GROUP 8 VCCINFX 1 OUFINDX 1 CALL INOUT TYPE S X258P06 PU PUTYP X258L07 LINE LCN 7 EL 7 WITHIN GROUP 8 VCCINFX 1 OUFINDX 1 CALL INOUT TYPE S 258 07 PU PUTYP 22 HOB HOBCOM under MVS OS 390 DEFINING TERMINALS AND PRINTERS LLCLIST this list must in any case contain LLC5 for the PAD IDBLKP this number must be entered in der switched major node for IDBLK for older NCPs that do not yet support the value 067 003 is to be entered PAD PAD INTEG is absolutely necessary TRAN no translation may be done for the laptop therefore TRAN NO is absolutely necessary X258L05 X258L07 are alle SVC Lines des Kanals All present SVCs must be entered at the laptop definiti on Macro X 25 VC can also be used instead of the macros X25 LINE and X25 PU HOB 23 DEFINING TERMINALS AND PRINTERS 3 3 3 Entry in the Switched Major Node Statements for IDBLK the ID numbers the LU names the Modtab and the Usstab are contained in the switched major node JOB JN CATALOG X25TE02 B REPLAC M X25TI LST DISP D CLASS C DI JOB 25 02 EXEC LIBR ACCESS SUBLIB GEOLIB SYS
3. ENTRIES TERMINALS If someone should receive a personal laptop password you may enter the parameter in the terminal table XCTERMA This parameter inverts the third Byte and replaces the fourth Byte of LTKEY You will find examples in chapter 3 3 HOB 69 TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and OS 390 6 14 EXIT ROUTINE XCUPNAM is an EXIT routine to enter individual routines in i e to generate the LU names or to reserve programs for certain users or terminals You can for example also achieve that your own SAPPL name is used at invoking the COVTC program This interface should only be used by practiced system programers since HOBCOM and its own data could be destroyed through unauthorized useage with this exit This interface should only be used by practiced system programers since HOBCOM and its own data could be destroyed through unauthorized useage with this exit At jumping into a subprogram and back into HOBCOM the conventions used by IBM must be followed The most important condition is the saving and later on the reloading of the registers After invoking your program Register 15 points to your program On displacement 0 you find the length of your program in a halfword di
4. PX PX KK KK In addition the PCT in the transaction that the assigned Terminal model will be using must be defined in the entry Macro DEFSCREEN ALTSCREEN If the model should be valid for all transactions the definition can be carried over into the initial macro 3 6 1 2 Definition using AUTOINSTALL or RDO Two tables are important for AUTOINSTALL and RDO TYPETERM and TERMINAL Example TYPETERM TYPETAB1 GROUP TYPG RESOURCE TYPE DEVICE LUTYP2 EL 2 SESSIONTYPE MAPPING PROPE 24 80 ALTPAGE 0 0 ALTSUFFIX AUTOPAGE DEVICE PROPE HIGHLIGHT ESSION PROPE ASCII NO BRACKET Y F F N 24 80 ALTSCREEN 0 0 LKYBD NO O YES SENDSIZE 255 RECEIVE 255 ES LOGMODE 0 When LOGMODE O is entered the dynamic generation of the terminal is performed according to the BIND parameter When a name instead of zero is given the terminal with this TYPETERM Definition will only then be generated when the name of the logmode is the same as the name registered in LOGMO At logon the name of the logmode is transfered from
5. 10 012 BAL 3456789ABCDEF ER PT A MESSAGE NOT PROCESSED 55 DC DC DC DC DC DC DC DC DC END 2 XCI X FOOF4COF6F X Fl16F6A506F6F6FA4C7C5B6F COMMAND 51 EXTA 2 LENGTH EGINNING OUTPUT KIND OF TERMINAL C HOBCOM NICHT VERE X CO7B C GBAR X F6F86F7B 23X 15 79x 00 X 40 25 MN 0 MESSAGE NO SESSION SWITCH OFF CODE DELAYED 7A REA UNTIL 24 LINE EERZEICHEN IN 24 AT THE END LINI HOB under MVS and OS 390 USSTABX LOGON TITLE PRI USS USS USS 55 55 55 55 55 55 55 55 55 55 55 55 55 55 55 55 55 55 55 55 55 55 55 55 55 DC NT TAB CMD PA PA PA CM PA PA CM PA CM PA PA CM PA CM PA MSG MSG MSG MSG MSG MSG MSG MSG END R R R D R R D R PAR M D R R D R D R A APPENDIX USSTABX HOBCOM USSTAB FOR HOB X PROTOKOLL NOGEN M PA M P1 M P2 M M LOGMOD M DATA IBMTEST FORMAT BAL CODX1 REP M APP CMD LOGON FORMAT M APPLID DEFAUL
6. X25TE02 VBUILD TYPE SWNET 257 01 PU ADDR 01 X25TO1L X25T02C X25TO02L X25T03C X25T03L 24 IDBLK 067 IDNUM 00006 PUTYPE 1 MAXDATA 265 MAXOUT 7 SSCPFM USSSCS ISTATUS ACTIVE LOCADDR 000 SSCPFM USSSCS MODETAB MODTABLT USSTAB USSTABLT ISTATUS ACTIVE ADDR 01 IDBLK 067 IDNUM 00004 PUTYPE 1 MAXDATA 265 MAXOUT 7 SSCPFM USSSCS ISTATUS ACTIVE LOCADDR 000 SSCPFM USSSCS MODETAB MODTABLT USSTAB USSTABLT ISTATUS ACTIVE ADDR 01 IDBLK 067 IDNUM 00002 PUTYPE 1 MAXDATA 265 MAXOUT 7 SSCPFM USSSCS ISTATUS ACTIVE LOCADDR 000 SSCPFM USSSCS MODETAB MODTABLT USSTAB USSTABLT ISTATUS ACTIVE E02 CLASS A DISP D EST SYSGI HOBCOM under MVS and 05 390 x KX x x x x 5 05 390 DEFINING TERMINALS AND PRINTERS IDBLK must contain the number from the NCP IDBLKP entry older NCPs use 003 IDNUM the ID numbers are given by the NCP at intervals of 2 X25T01L X25T03L these LU names are simultaneously the HOBCOM TCT master entries for laptops MODETAB here the name of the modetab for laptops is given thus MODTABLT USSTAB here the name of the Usstab for laptops is given thus USSTABLT 3 3 4 Logmode for Laptops To logon
7. END USSEND 5501 EQU VTAM MESSAGE 1 DC AL2 5 LENGTH DC X 4100010141 MESSAGE MESS02 EQU VTAM MESSAGE 2 DC AL2 5 LENGTH DC X 4100010242 MESSAGE MESS03 EQU VTAM MESSAGE 3 DC AL2 5 LENGTH HOB 25 DEFINING TERMINALS AND PRINTERS HOBCOM under MVS and OS 390 DC X 4100010343 MESSAGE 5504 EQU 4 DC AL2 5 LENGTH DC X 4100010444 MESSAGE MESS05 EQU VTAM MESSAGE 5 DC AL2 5 LENGTH DC X 4100010545 MESSAGE MESS06 EQU VTAM MESSAGE 6 DC AL2 5 LENGTH DC X 4100010646 MESSAGE MESSO7 EQU 7 DC AL2 5 LENGTH DC X 4100010747 MESSAGE MESS08 EQU VTAM MESSAGE 8 DC AL2 5 LENGTH DC X 4100010848 MESSAGE MESSOC EQU DC AL2 5 LENGTH DC X 4100010C4C MESSAGE MESSOD EQU VTAM MESSAGE D DC AL2 5 LENGTH DC X 4100010D4D MESSAGE END EXEC LNKEDT amp EOJ LTC1 LTC2 USSTAB commands to logon an application in our case the HOBCOM machines HOBCMC1 HOBCMC2 one of these commands ist to be entered into the PAD setup of the PC HOBCMC1 HOBCMC2 two different VTAM APPL names Please note tha
8. 5 05 390 System Manual November 2000 HOB electronic GmbH amp Co KG Brandst tterstr 2 10 D 90513 Zirndorf 00 49 911 96 66 290 00 49 911 96 66 299 support hob de 5 05 390 Inhalt 1 GENERAL REMARKS 8 Tate OVERVIEW rm 8 1 2 THE HOBCOM 5 9 1 3 THE HOBCOM 9 1 4 CONVENTIONS a nn tt de tq oe cken 10 2 INSTALLATION GUIDE 12 2 1 STEPS FOR A FIRST 12 2 2 LOADING THE MAGNETIC 13 2 3 DEFINTION OF THE PROGRAM HOBCOM IN THE PROGRAM PROPERTY TABLE 15 2 4 STARTING e ed Ri ie 16 3 DEFINING TERMINALS AND PRINTERS 18 3 1 STANDARD 3270 TERMINALS AND PRINTERS 18 3 2 DEFINING THE REAL E TERMINALS IN 19 3 3 DEFINING A LAPTOP PC WITH HOBCOM 21 3 4 COMMUNICATION OVER TCP IP DEFINITION OF A TN3270 27 3 5 DEFINING THE MAJORNODE HOBCOM THE APPLICATION HOBCOM AND THE VIRTUAL TERMINALS AND PRINTERS IN 29 3 6 DEFINING THE VIRTUAL TERMINALS IN THE APPLICATIONS
9. DOPOSUD DOAZ DOZO D HOB HOBCOM under MVS OS 390 A APPENDIX A 11 STANDARD ASSIGNMENT OF HOBCOM DRIVER ROUTINES The driver routines described in this manual are not part of all standard shipments of HOBCOM HOB TEXT or HOBLIST The following table shows you which driver routines are linked to the HOB products HOBCOM HOBLIST VM v v v SPOOL v PUN v v v PRINT v v v SCREEN v TCT v DIALOG v APPCVPI v v v APPCVPW v v v VMFILEP v v v VSAM v E 5 05 390 A APPENDIX A 11 THE HOBCOM CHARACTER SET 112445 E l um p 9 amp f 5 0 QJ anl L B aero E OL ES NT UJ u nr 8 gt COT Xr C CE im B OI 7 OT C O 2 5 I Cc oO DO gt U zZ c 1 x x 2 Et ESTUUUxY2ZI 012345565789 CE Oro J 1 HOB 172 under MVS OS 390 A APPENDIX HOB 173 INDEX HOBCOM under MVS and OS 390 INDEX A ACB NAME
10. LOAD ALL THE STEPS EXEC PGM IEBCOPY SYSPRINT DD SYSOUT IN1 DD DSN HOBCOM TEMPLIB DISP SHR IN2 DD DSN HOBCOM MACLIB DISP SHR IN3 DD DSN HOBCOM LIB1 DISP SHR DSNAME HOBCOM LOADLIB UNIT TAPE VOL SER HOBCOM LABEL SL DISP NEW KEEP TAPE2 DD DSNAME HOBCOM MACLIB UNIT TAPE VOL SER HOBCOM LABEL 2 SL DISP NEW KEEP TAPE3 DD DSNAME HOBCOM LIB1 UNIT TAPE VOL SER HOBCOM LABEL 3 SL DISP NEW KEEP SYSIN DD COPY 1 COPY 2 2 COPY 2 3 DEFINTION OF THE PROGRAM IN THE PROGRAM PROPERTY TABLE In the Program Property Table the following entries are necessary BROWSE SYS1 PARMLIB SCHEDXX 01 00 LINE 00000090 COL 001 080 COMMAND gt SCROLL gt PAGE PGMNAME XCHOBCOM PROGRAM NAME KEY 8 PROTECTION KEY NOSWAP NON SWAPPABLE AFF 1 NO PROCESSOR AFFINITY KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK The entry NOSWAP means that with HOBCOM no Swap is performed If this entry is not made the performance may deteriorate The entry AFF 1 means HOBCOM runs only one processor This entry is mandatory if more than one processor exists HOB 5 INSTALLATION GUIDE HOBCOM under M
11. Example for LUTYPE 3 DFHTCT TYPE TERMINAL RMTYPE LUTYPE3 COMPAT NO ERRATT NO ESIZE 24 80 ESTAT AUTOPAGE L 255 TIOAL 160 RMSTAT TRANSCE RMIDNT NOIP xx KK KK KM KK KK ETNAME NO1P TRMPRTY 0 Invoking in HOBCOM The programm PR3287 has to be invoked in the HOBCOM background Example 87 PRINTING WITH HOBCOM under MVS and OS 390 EXEC PR3287 PA CICS SA NO1P PRI N01 PARAM FSP17 LLM AGO this is the SAPPL name You will find a more detailed desription of the programms PR3287 in the HOBCOM User s Manual 8 3 PRINTING FROM JES ON E TERMINAL PRINTER Programm PR3770 allows you to print directly from your spool system on a HOBCOM printer The HOBCOM printers emulate RJE stations and must be defined as such in JES In order to be able to address an HOB printer as a RJE station it is necessary to make an entry in JES under MVS The following is an example of an entry in JES2 LOGON1 APPLID J amp MAXSESS nnnn amp NUMLNES nnnn amp NUMLOGS 1 amp NUMRJE nnnn amp nnnn mmmm amp TPIDCT 31 INEl UNIT SNA RMTnnnn DEVTYPE LUTYPE1 BUFSIZE 512 NUMPRT 1 NUMRDR 0 NUMPU 0 1 COMPRESS NO COMPACT NO SETUP PDIR CONS YES STRMTnnnn Rnnnn PR1 PRWIDTH 132
12. CMPCT NO CCTL YES Enter the name of the VTAM application as APPLID MAXSESS defines the maximum number of VTAM sessions NUMLNES is the number of lines NUMLOGS is the number of JSE2 VTAM interfaces NUMRUE is the number of the RJE stations NUMTPBF is the number of the JSE2 TP buffers The following is an example of an entry in JES3 In JES3 you define the HOBCOM printer as 3776 RJE stations COMMDEFN APPLID JES3 LU 5 CONSOLE JNAME RMTO1 TYPE RJP DEST NONE LEVEL 15 DEVICE DTYPE RMTPRINT JNAME RMTOIPRI XLATE NO RJPWS N RMTO1 RD 0 PR 1 G RMTO1 AUTO N COMPACT NO C R The VTAM ACB name and the maximum number of LUs are to be entered in the first line Example of an invocation EC PR3770 PA 1 PRINTER N01 PARAM FSP17 MSG RMTO1 HOBCOM under MVS OS 390 PRINTING WITH HOBCOM You will find the complete description of the program PR3770 in the HOBCOM User s Guide 8 4 Printing over HOBCOM on the system printer The driver routine PRINT makes the print output on a system printer possible For example an HOB TEXT text is transfered in the IBM format and the output on printer that doesn t support the HOBTEXT format is possible Especially there happens no transfer in the ASCII format 1 Part filename fix PRINT With DYNALLOC SVC 9
13. 60 6 10 PERSONAL ENTRIES 5 64 6 11 LOGON MASK BY S AND X SCREENS XCSYSCTL 65 6 12 JGE ENTRIES XCUCLTAB ua vote ed e evo Ee Po edie 66 6 13 PASSWORD FOR LAPTOPS LTKEY ner 69 6 14 EXIT ROUTINE senes 70 6 15 AUTHORIZATION FOR HOBCOM OPERATOR COMMANDS XCCOMASK 73 6 16 HOBCOM SGHEENMASK en 73 6 17 HOBCOM PASSWORD XCPASSW ener 80 DEFINING PCS WITH HOBLINK 3270 Y PROTOCOL 81 7 1 GENERAL REMARKS CONCERNING THE INSTALLATION seem 81 7 2 PASSWORD IN THE HOBCOM 81 7 3 PERSONAL ENTRY IN THE HOBCOM nnns 81 83 7 5 HISSTAB E SOM im that aa 83 PRINTING WITH HOBCOM 65 8 1 PRINTING FROM CICS ON STANDARD 3270 essen 85 8 2 PRINTING FROM CICS ON E TERMINAL 87 8 3 PRINTING FROM JES ON E TERMINAL 88 8 4 Printing over HOBCOM on the system 89 8 5 PRINTING A HARDCOPY ON E TERMINAL 90 8 6 P
14. ri This USSTAB can also be used with VTAM Version 3 USSTABS1 LOGON TIT PRI SS SS SS SS SS SS SS SS SS SS SS U U U U U U U DC DC DC DC DC NT TAB CMD PAR PAR PAR USSTABS1 NOGEN CMD LOGON FO PARM APPLID PARM LOGMODI PARM DATA M M M RMAT PL1 CMD CMD IBMTEST FOR PARM PARM P1 DEFAUL PARM PARM P2 DEFAUL BAL 10 0123456789ABCDEF HOBCOM USSTAB FOR SNA CONTROLLER MSG MSG 2 BUFFER PT MESSAGE NOT PROC ESS ED MSG MSG 10 BUFFER P EXTA MESSAGE END 12 x c1 X FO6FAC6FEF X F6FO5BEO 23X 15 79x 00 X 40 EXTE PT EXTA 2 H STA KIND OE SWITCH OFF CODE ENGTH RT OUTPUT jS AREA UNTIL 24 LIN IF NO SESSION ONCE ri F BLANK IN 24 BLANK AT THE INE END 167 APPENDIX 168 055 52 LOGON under MVS and OS 390 TITLE USSTABS2 HOBCOM USSTAB FOR SNA CONTROLLER PRINT NOGEN USSTAB USSCMD CMD LOGON FORMAT PL1 USSPARM PARM APPLID USSPARM PARM LOGMOD USSPARM PARM DATA SSCMD CMD IBMTEST FO SSPARM PARM P1 DEFAUL SSPARM PARM P2 DEFAUL SSMSG MSG 2 BUFF SSMSG MSG 10 B
15. 0093 ID xxxxxxxx RELREQ GETMAIN GETVIS ERROR Not enough memory to call the EXIT Routine RELREQ 124 under 5 OS 390 MESSAGES 0094 ID xxxxxxxx NSEXIT GETMAIN GETVIS ERROR Not enough memory to call the EXIT Routine NSEXIT 0101 TPEND HALT NET NORMAL VTAM has been ended using the command Z NET HOBCOM is also ended if no users are acti ve 00102 TPEND HALT NET QUICK VTAM has been ended using the command Z NET QUICK HOBCOM is also ended if no users are active XCTMO01 11 ACB OPEN ERROR xxH ID xxxxxxxx An OPEN ERROR is indicated while opening the VTAM ACB of the terminal control task nor mally IDZCODIS The error code is displayed in hexadecimal form hexadecimal Refer to the VTAM Programming manual in particular the chapter on Description of the VTAM Macro Instructions 0111 OPEN ERROR XXH ID xxxxxxxx NOT DEFINED This is a special form of the error message 0111 An OPEN ERROR is indicated while opening the VTAM ACB of the terminal control task normally IDZCODIS The error code indica tes that the VTAM node has either not been defined or has been inactivated The corresponding VTAM node must be activated Consult the VTAM Programming Manual in particular the chap ter on the Description of the VTAM Macro Instructions XCTMO0111 OPEN ERROR XXH ID xxxxxxxx ALREADY IN USED Special form of error mess
16. GETSOCK routine liefert f r SOCKET keine SOCKET NR x 5FD IUCV Send f r SOCKET fehlerhaft x 5FE IUCV Send f r SOCKET completed mit IPAUDIT 0 x 5FF IUCV Send f r SETSOCKOPT fehlerhaft 146 HOBCOM under MVS and OS 390 HOB under MVS OS 390 A APPENDIX A APPENDIX A 1 SAMPLE JOBS A 1 1 Jobs to Load the HOBCOM Program Phase and the Libraries The program phase is loaded together with the libraries Sample job TAPINHC ACCT HOBCOM L EVEL 1 1 LER ERS LOADS HOBCOM FROM E LIBRARIES COPY EXEC PGM IEBCOPY SYSPRINT DD SYSOUT 1 DSN HOBCOM LOADLIB LABEL 1 SL DISP SHR UNI VOL SER HOBCOM DSN HOBCOM MACLIB LABEL 2 SL DISP SHR UNI APE VOL SER HOBCOM TAPI DD DSN HOBCO UNI APE VOL TARG1 DD DSN HOBCO TARG2 DD DSN HOBCO TARG3 DD DSN HOBCO SYSIN DD COPY INDD TAPI DD TARG1 COPY INDD TAPI DD TARG2 COPY INDD TAPI DD TARG3 MSGCLASS X LIBl LABEL 3 SL DISP SHR ER HOBCOM EST LINKLIB DISP SHR EST MACLIB DISP SHR EST LIBl DISP SHR lt lt Zu ZN If you are using UCC1 enter the following label LABEL EXPDT 98000 It could be advantageous from a standpoint of performance
17. epi idtret 43 Anschlu des Token Ring Terminals 39 AUTOINSTALL eher 32 C CO do eo ee b be d pets 58 Connect iere e RR COVTC COVTOP MESSAGES entree mr ere edet ERR D Define 3270 Printer nal Rees tiber 18 3270 Terminal et ERO Ert 18 Terminal eerte eene INR 19 Virtual 31 8 98 i 28 Driver 100 344 47 Driver 20 2 47 Drucken von HOBCOM zu einem LPD 100 F E nktionstasten re Eee Ne eara des 10 H HOBEINK 3270 haeo oO 98 hostname icone p etd eene 28 I E E ARTER esnin hnn ea First Installation Loading the Tape Properties eene tigre ERSTE Tape Gontent rettet bees Installationsband J Jobnainezs 28 L LAS TEE 98 Loading eere 14 Loading the HOBCOM Programmphase 14 NCP ERDty 22 Switched Major 24 27 Terminals and 18 USSTAB z cente USSTABLT VIRTUAL PRINTERS eee 35 174 MVS CONSOLE MESSAGES 118 5 05 390 INDEX N NCP ENY
18. 22 9 NOTE MESSAGES 129 O OBEN ecu cente re OUTFILE Overview Books ae Programs 9 Styles 2e roro d NL PEE 10 P PR328 9 PR3287 MESSAGES reete 131 PR3770 oc ERRORI 9 Print A LOCAL HARDCOPY ere 88 DET terminal 52 2 deett bee RE 83 Print Client ad REESE ees 28 Program Property 15 Properties R RDO u ds 32 RIE Stati Oni 4 1i pee 9 ROSCOE nho n EM REUS 34 S S DEIUCkeE reos tinm eene ere pe ere iet 95 Start HOBCOM 2 16 Storage Requirements 12 Switched Major 24 SYSTEM 2 222 222 CREE EDU 59 T TASKS TA ette 59 TERMSTA The Driver 100 TN3270 Drucker Session eee 95 USSTAB for eres USSTAB f r Laptop WSS TABHS 3502 ente oe D nee USSTABET uS MAP NU 9 X un ER EN IRIS 71 XCICDLEAB 3 ue ete 64 XCPASSW eene EORR Ri 78 XGPERSTA eot eie dee ens 62 52 eei 46 XCTCPIP2 103 139 XCTEGRO Group Entries for Terminals 48 XETERMA 43 XCTBRL 95 97 XC
19. 100 is linked In the XCTCT a driver by XCPRTAB is installed EQU X 0100 X 0C 00 X SCOP0100 An entry with the macro XCTPRI does not be made for the printer TN3270E printer 2 HOB under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM 6 5 GROUP ENTRIES FOR TERMINALS XCTEGRO The label XCTEGRO serves to define terminal groups When the XCTERMA table is opened it is determined if a terminal belongs to a group and if it does to which group it belongs ERMA DS OF ADDRESSES OF TERMINALS XCTCT TERM terminalname ADDR X xxx PRINT printertyp GROUP qglabel XCTEGRO The group name the name of the terminal mask assigned to the group as well as the name of the appro priate command table are to be entered in the macro XCTEGRO OF Ero Y XCTEGROE XCTEGRO LENGTH OF TABLE EGRO LABEL glabel NAME gruppe USSOUT gussout USSCOM gusscom COMASK operator commands TIMEOUT n MASKP n PnCOM usscom command EQU glabel Group label You can choose this name freely and is used in the macro XCTCT group group name You can choose this name freely and is used in the macro XCPERS gussout name of corresponding console mask gusscom name of corresponding command table operator commands additionally allowed operator commands see p 73 F
20. 4 4 CONNECTING TOKEN RING TERMINALS Token Ring Terminals are connected according to the following sceme Anwendung Host VTAM ries ex les Token Ring Steuereinheit Gateway R ngleituags vereiler Token Ring Ringeitungs H ths lors VOCS Y Protokoll CODLOG11 X Protokoll CODLOG10 39 Creating termnial and usergroups HOBCOM under MVS and OS 390 5 Creating termnial and usergroups With HOBCOM you have the possibility to group several user or terminals Therefore it is possible to assign authorizations in groups 5 1 In general The assignment of the terminals persons to the groups you define in the HOBCOM table XCTCT see the following paragraph Therefore are entries in the following tables necessary e XCTEGRO e XCPERS An example for that you can find the appendix of this manual The table XCTEGRO In the table XCTEGRO you define with the macro XCTEGRO the characteristics of a usergroup You can define command abbreviations and the appearance of the HOBCOM basic mask as well as the autho rization for HOBCOM operator commands The table XCTERMA In the table XCTERMA you define with the macros XCTCT XCTSTE and XCTPRI to which group a termi nal should be belong The table XCPERSTA In the table XCPERSA you define with the macro XCPERS to which group a person should be belong 5 2 Identification by announcing to HOBCOM The anouncing on
21. 1 part filename fix DIALOG The second part filename is the name of the dialog as it is defined in the VCTCT The third part filename depends on if data will be read or written for reading give the system name of the file from which will be read for writing enter the name of the VM user on whose console the data shall be written If you want further information about the dialog driver routine please contact the HOB software support 10 7 With VSAM you have access to a VSAM file The access via index key is supported Every task that opens an access with VSAM creates its own ACB Several ACBs can be opened per file It is not pos sible to write data 1 part filename fix VSAM The second part filename marks the type of the file ESDS without key or KSDS with key The third part of the filename gives the name of the file This name is entered in the XCTCT using the XCJCL2 macro Example In HOBTEXT data of a VSAM file can be transferred into the text processing system In the file descripti on the desired file is announced to the system EXTERN SVSAM KSDS FILEO1 HOB ns HOBCOM DRIVER ROUTINES HOBCOM under MVS and OS 390 Please note that stands for the context command character in the box Like this a file with key field is defined the name of the file is entered in the XCTCT as follows XCJCLTAB DS OF XCJCL2 NAME DATEI1 CODD DSN SDATEI VSAMT1 DISP
22. YES NO This parameter defines when the command stated by the parameter COM will be executed TERMSTA YES This is the default value The command is executed if the screen is switched on respectively by connecting the end device to HOBCOM TERMSTA NO The command is executed if the screen is switched of respectively by the input of the command LOGOFF the HOBCOM basic mask The parameter TERMSTA shouldn t be used simultaneously with the pa rameter SYSTEM YES NO This parameter indicates if a task is to be started if it does not yet exist TASKSTA YES The command is also executed if no task is existing In this case the task is started This is the default value TASKSTA NO The command will only be executed if the task already exists The parameter TASKSTA shouldn t be used simultaneously with the pa rameter SYSTEM YES NO BTPRI YES results that the terminal name is saved which the task has started That can be name respectively created from HOBCOM If respectively HOBLink 3270 or HOBLink J Term are started without a resource name TN nnnn is created as terminal name nnnn is a continuous number with the maximum length of four characters BTPRIZNO is the default value If NO is set HOBCOM forgets immediately after starting the task which termi nal caused the starting of the task Example 61 predetermined which terminal name is created for that it can be started with the personal
23. 03 ESP RUSIZI ROF X 03 X B1 SECPROT X 90 X 0000 RUSIZI X PROTOCOL ES X 8989 000000185000007 00 ES X 87F8 0000001850000071 00 ES X 88F8 000000185000007 EO0 ES X 8888 PSERVIC X 028000000000000000001000 END OGMOD MODTABCO HOBCOM MOD F ENTRYC PRIPROT RUSIZES EN MP X B1 SECP X 87F8 PS OGMOD PRIPROT RUSIZES OGMOD E D4C32782 RO X 90 CO ERVIC X 0280 MPROF X 0 X Bl SECP X 87F8 PS E DSILG PRIPROT RUSIZES END NOGEN MODTABLT ENTRYC 164 AB ENT LOGMOD RO X 90 CO ERVIC X 0280 MPROF X 0 X B1 SECP X 8785 PS RO MODTABLT HOBCOM MOD F PRIPROT END ETAB FOR USING NCCF ROF X 03 TSPROF X 03 ROT X 3080 0000001850000071 TSPROF X 03 ROT X 3080 0000001850000071 TSPROF X 03 ROT X 3080 ETAB FOR LAPTOPS ENTRYC FMPROF X 03 TSPROF X 03 X B1 SECPROT X 90 COMPROT X 3040 HOBCOM under MVS and 05 390 ERVIC X 028000000000000000000200 HOBCOM under MVS OS 390 A APPENDIX A 10 HOBCOM USSTABS TITLE USSTABN1 HOBCOM USSTAB
24. PW this parameter is optional It is necessary if a password is expected from PDC and only user should print who know the password Example XCTERMA DS OF ADDRESSES OF THE TERMINALS XCTPRSMB TERM TEST10 TYPE LPT1 PROT 0 NOSESS 0 PRINT 20 SMBDOM HCDOM PW test PCNAM WRKST PCPRINAM wrk_stpr XCTPRSMB TERM TEST20 TYPE LPT1 PROT 2 NOSESS 0 PRINT 10 SMBDOM HCDOM PCNAM wrkst2 PCPRINAM wrk st2pr XCTPRSMB TERM TEST30 TYPE LPT1 PROT 4 NOSESS 0 PRINT 0100 SMBDOM HCDOM PCNAM WRKST3 PCPRINAM WRKST3PR LASTTE YES Endekennung XCSMBDOM DS OF DOMAIN BEGINNING SMB DRUCK XCSMBDD NAME HCDOM DOMAIN DOM100 HCNAMED HOBCOM IPADDRP 123 45 678 121 IPADDRS 194 45 234 121 USERID Test PW test AL2 0 END MARKING HOBCOM AND HOBCOM under MVS and OS 390 n2 HOB under MVS OS 390 HOBCOM DRIVER ROUTINES 10 HOBCOM DRIVER ROUTINES HOBCOM driver routines build interfaces between your system environment and HOBCOM uses They consist principly of three parts that are separated from each other through a point the first part is always fixed and contains the driver name The two following parts differenciate with the different drivers and depend partly on the uses 10 1 SPOOL The driver routine SPOOL is necessary for printing the output results either on a terminal printer or it will be temporarily stored on a disk the last is only possible using HOBT
25. C COPO0009 PPRINT12 EQU PPRINT42 EQU DC 0012 DC 0042 DC DC DC DC 152 HOB HOBCOM under MVS OS 390 A APPENDIX C COP0012 DC C COPO012 HOB 153 APPENDIX 5 05 390 The following table shows the characteristics of the two drivers and gives examples of printers which rununder them Basic Italics Character Set CG1 extended Epson Character Set CG2 Benz 1 180 1 216 1 180 pus e RN SQ 2550 MT 90 MT 330 e 905 Examples LQ 2550 SQ 2550 154 under MVS and OS 390 A APPENDIX A 4 EXAMPLE FOR AN EXIT ROUTINE This exit routine assigns LU addresses from a pool CK Ck Ck CK Sk Ck Ck CK Ck Ck Ck Sk Ck Ck Ck Ck Ck Sk ck Ck Ck Sk ck Ck ko Sk Sk Ck kx XCUPNAM DS OF EINSPRUNG DC Y PEXEND LENGTH OF PROGRAM AK KH REGISTER DEFINITIONS OCC cC Ck CC CK CCS CC C Ck CC CC CK Ck CK Ck CK C Ck Ck Ck C CC CK
26. a target machine USER and a class CLASS or a Tag TAG are entered XCJCLTAB DS OF XCJCL1 NAME name USER targetmachine CLASS class NNAME Here you enter a freely chosen name This name may be up to 8 characters long This entry will be shown connected with a driver program as part of the name when invoked Example OUTFILE PUN PRINT name USER enter the name of the virtual machine to which the data which has been read is to be spooled CLASS enter the class under which the read data is to be spooled Afterwards starting and end control cards for the data will be entered with help of the XCUCL1A and XCJCL1E macros that i e should be transmitted from a HOBCOM driver program and must yet be worked on according to these control cards These macros can occur several times per JCL en try and are also allowed with the XCJCL2 macro Use the macro XCJCL1A to define the control cards that are to be placed at the beginning of the read data You can define several XCJCL1A macros XCJCL1A LINE text LINE enter a JCL card enclosed in apostrophes which is to be placed at the beginning of the data which is to be read Use the macro XCJCL1E to define the control card that is to be placed at the end of the data which is to be read Several XCJCL1E macros may be defined XCJCLIE LINE text LINE enter a JCL card enclosed in apostrophes which is to placed at theend of the data to be read Use the
27. Example LOGON1 APPLID J amp MAXSESS nnnn amp NUMLNES nnnn amp NUMI E nnnn MTPBF nnnn mmmm IDCT 31 El UNIT SNA RMTnnnn DEVTYPE LUTYPE1 BUFSIZE 512 NUMPRT 1 NUMRDR 0 NUMPU 0 UNAME NO1P COMPRESS NO COMPACT NO CONS YES STRMTnnnn A Y Rnnnn PR1 PRWIDTH 132 CMPCT NO CCTL YE Enter the name of the VTAM application as APPLID MAXSESS defines the maximum number of VTAM sessions NUMLNES is the number of lines NUMLOGS is the number of JSE2 VTAM interfaces NUMRUE is the number of the RJE stations NUMTPBF is the number of the JSE2 TP buffers HOBCOM under MVS OS 390 DEFINING TERMINALS AND PRINTERS 3 7 2 2 Definition in JES3 In JES3 you define the HOBCOM printer as 3776 RJE stations Example COMMDEFN APPLID JES3 LU 5 CONSOLE JNAME RMTO1 TYPE RJP DEST NONE LEVEL 15 DEVICE DTYPE RMTPRINT JNAME RMTO1PR1 XLATE NO RJPWS 1 RD 0 PR 1 G RMTO1 AUTO N COMPACT NO The VTAM ACB name and the maximum number of LUs are to be entered in the first line 37 CONNECTING THE TERMINALS HOBCOM under MVS and OS 390 4 CONNECTING THE TERMINALS 4 1 REPLACING A TERMINAL WITH A HOB E TERMINAL If you have not yet replaced your terminal with an E terminal you can enter the following string on the terminal att
28. HOBCOM under MVS and OS 390 DS OH ENTER LA PEXPOOL1 BEGIN OF POOL LA PEXPOOL2 PEXPOOL1 8 NUMBER DS OH CHECK ENTRY CLC 0 8 4 8 IHIS APPL BE 10 H YES LA RH4 8 RH4 NEXT ENTRY BCT RH3 PEXI04 CHECK B PEXROK ALL READY DS OH ENTRY FOUND ICM RHO 15 SASUPNAT GET ADDRESS OF INTERIM STORAGE BZ PEXP2O H MISSING LA RH2 4 RH0 FROM HERE ENTRIES LH RH3 2 RH0 NUMBER OF ENTRIES XR 1 1 UNTIL YE FREE ENTRY DS OH CHECK ENTRY CLC 0 8 RH2 8 RPARA THIS APPLID 20 H YES CLI 0 RH2 0 ENTRY FREE BNE 14 LTR RH1 RH1 REMEMBER FREE ENTRY BNZ 14 LR RH1 RH2 NOTE FREE ENTRY DS OH ENTRY LA RH2 8 RH2 NEXT ENTRY BCT RH3 PEXI12 CONTINUE SEARCHING LTR RH1 RH1 ENTRY FOUND BZ 40 0 8 RH1 0 RH4 ENTRY OCCUPI
29. INVALID The value for FREETIME may not be null zero HOB 137 MESSAGES HOBCOM under MVS and OS 390 ERROR PR020009 EXIT R You can build your own Exit Routines into your XCTCT that give back error codes These are put out under these error numbers ERROR PR020010 SESSION ACTIVE LOGON NOT POSSIBLE A LOGON to a VTAM application has already been executed ERROR PR020011 NO SESSION ACTIVE NO LOGOFF The session with the VTAM application was not activated or has already been ended ERROR PR020012 TEXT AFTER COMMAND 15 INVALID Text has been entered following the command LOGOFF SHUTDOWN GO or HALT These commands must be entered without any text ERROR 020013 P E HOBCOM has received an error message from the printer hardware fault Consult the following list for the meaning of the error messages 01010001 Terminal non existent A print task must be started for this terminal Use EXEC COBA 01010002 printer generated There is no driver entered in the TCT for this printer 01010003 Terminal is turned off Turn the terminal on and enter GO in the COBA 01010004 Printer is turned off Turn the printer on and enter GO in the COBA 01010005 Driver program not available The selected driver is not entered in the TCT 01010006 Printer is busy Wait a while and then restart the print 01010101 Unknown printer Either an entry in the JCL table is missing or there is a mistake in the printer
30. should adress the printer is the name of the definition who was created with the macro XCSMBDD This name refers to the domain description macro XCSMBDD which is used by the printer is the number of the session over that you can print This parameter is optional The value 0 means that the number of sessions is unlimited A value unequal 0 signs how many PR3287 tasks at the same PRI can be printed simultaneously With Value 1 it is possi ble to start several printing programs at the same PRI but they can only print one after one If you print simultaneously the PC will control over the print number so that the lists are not printed mixed at the moment ist only the entry LPT1 possible Is the name of the PC inside of the Windows domain where the printer is connected The WINS server receives this name and passes the print datas on the corresponding TCP IP address Attention The WINS server receives this name in capitals Is the name of the used printer This name is always known with capitals in the Windows network If a password for the used printer is entered at the PC it has to be announced to HOB COM So HOBCOM is authorized to print on that printer Here the SMB dialect is adjusted which HOBCOM should propose by the communication Possible values from 0 to 6 0 PC Network Program 1 0 1 Microsoft Networks 1 03 Attention By the dialects 0 and 1 no Userid can be sent only a password The password is used in thi
31. to copy the HOBCOM module in an authori zed library and to define it as non swapable Our Tape Was Created Using the Following Job Steps STEP4 EXEC PGM IEBCOPY SYSPRINT DD SYSOUT IN1 DD DSN HOBCOM LINKLIB DISP SHR OUT1 DD DSN HOBCOM TEMPLIB VOL SER MVSDL2 UNIT 3380 DISP NEW CATLG SPACE CYL 1 1 3 DCB RECFM U BLKSIZE 23200 HOB 147 A APPENDI X HOBCOM under MVS and OS 390 LISESIN BBpy T IN1 0 OUT1 SELECT MEMB ALL HAS TO SAV STEPS5 EXEC PGM IEBCOPY SYSPRINT DD SYSOUT IN1 DD DSN HOBCOM T IN2 DD DSN HOBCOM MACI IN3 DD DSN HOBCOM L 1 DSNAME HOBCOM VOL SER HOBCOM TAPE2 DD DSNAME HOBCOM VOL SER HOBCOM TAPE3 DD DSNAME HOBCOM VOL SER HOBCOM SYSIN DD COPY 1 2 2 COPY I IN3 O TAPES3 ER XCHOBCOM XCHOBCST ED ON TAPE EMPLIB DISP SHR LIB DISP SHR IB1 DISP SHR UNIT TAPE 51 DISP NEW IB UNIT TAPE 2 SL DISP NEW LIB1 3 SD DISP NEW A 1 2 Job to
32. 00115D7F40 BLANK AT THE END END is HOS under MVS and OS 390 TITLE USSTABSA LOGON PRI SS 55 55 55 55 55 55 55 55 55 55 55 55 U U U U U U U U DC DC DC DC DC DC DC DC DC A APPENDIX NT TAB CMD PAR PAR PAR CMD E CMD LOGON FO PARM APPLID PARM LOGMODI PARM DATA CMD IBMT M M M PARM PARM P1 DEFAUL PARM PARM P2 D CMD CMD CODIS PARM PARM APPL EFAUL OGON FOR ID DEFAULT CODIS RMAT PL1 EST FORMAT BAL 10 0123456789ABCD MAT PL1 MSG MSG 4 BUFFER PTE XTA USSTABSA HOBCOM USSTAB FOR SNA AND VTAM VERSION 1 HOBCOM NOT RUNNING MSG MSG 10 BUFFER PT EXTA MESSAGE IF WITH END AL2 PT X FO6FAC6FEF X Fl16F6A506F6F6F4 EXTE PT EXTA 2 LENGTH BEGINN OF OUTPUT KIND OF TERMINAL C7C5B6F COMMAND 51 C HOBCOM NICHT X CO7B C GBAR X F6F86F7B 23X 15 79X 00 X 40 VERF SIGN TEXT FIELD UNTIL THE 24 OUT SESSION WITCH OFF CODE DELAYED LINE LANK IN 24 LANK AT THE ND INE END S E
33. 2 THE HOBCOM PROGRAMS The HOBCOM programs can be divided in two main categories e Programs establishing a connection to the application COVTC COVTOP allows communication of the terminal with other applications Programs at least peripherally handling printers COBA allows starting checking and terminating batch programs NOTE allows saving screen contents and printing of hardcopies PR3287 emulates a 3287 printer PR3770 emulates a 3770 printer and enables printing from power as an RJE station 1 3 THE HOBCOM DOCUMENTATION The HOBCOM Documentation consists of two manuals System Manual The system manual which you read concurrently turns to the administrator of the host system It will inform you about installation and configuration of HOBCOM Information about the usage of HOBCOM that are already contained in the User Manual is not contained in the System Manual once more User Manual The User Manual turns to the users of the terminals or PCs that are connected to HOBCOM The User Manuals describes the commands that are possible in HOBCOM shows you how to print with HOBCOM and explains the error messages that HOBCOM displays o GENERAL REMARKS HOBCOM under MVS and OS 390 1 4 CONVENTIONS In this manual these styles are used In this place useful notes are given In this place important notes and additional information is given that should be considered The stop signal warns you of all actions tha
34. CC Ck Sk Ck CK Ck S Ck Ck A AK Sk A ke A ko koX ROO EQU 0 ROI EQU 1 RO2 EQU 2 RO3 EQU 3 RO4 EQU 4 ROS 5 RO6 EQU 6 R07 EQU 7 R08 EQU 8 R09 EQU 9 R10 EQU 10 R11 EQU 11 R12 EQU 12 R13 EQU 13 R14 EQU 14 R15 EQU 15 EQU 2 PARAMETER PASS RDAT EQU 3 ADDRESSING DATA RHO EQU 4 HELP REGISTER 0 EVEN RH1 EQU 5 HELP REGISTER 1 RH2 EQU 6 HELP REGISTER 2 RH3 EQU 7 HELP REGISTER 3 RH4 EQU 8 HELP REGISTER 4 RPROG EQU 9 ADDRESSING WITHIN PROGRAM RSP2 EQU 11 SYSTEM PARAMETER 2 RSP1 EQU 12 SYSTEM PARAMETER 1 RSYS EQU 13 ADDRESS system area USING SASBLOCK RSYS SYSTEM ADDRESSES STM R14 R12 12 R13 SAVE REGISTER BALR RPROG O PICK ACTUAL ADDRESS USING RPROG PROGRAMM ADDRESSABLE LR RPARA R01 GET PASS 1 80 PEXROK E NO JUMP BACK CLI 0 RPARA 0 ENTER BNE PEXOUT CLI 8 RPARA C JEROM POOL BE PEXPOO 7 5 CLI 8 RPARA 0 ANYTHING PASSED BNE 02 5 8 8 RPARA 16 RPARA CALCULATED HOB 155 APPENDIX 02 04 10 12 14 20 PEXPO2 04 PEXPO6 156
35. CO DISPLAY DISK CO DISPLAY PROGRAMS CO DISPLAY STORAGE CO DISPLAY TASKS CO DISPLAY TASKS FULL CO DISPLAY TASKS BATCH CO DISPLAY TASKS BATCH FULL CO DISPLAY TASKS DISCONN CO DISPLAY TASKS HALT CO DISPLAY TASKS TERMINAL CO DISPLAY TASKS PERS CO DISPLAY TERMINAL CO DISPLAY TERM CO DISPLAY VERSION CO DYNALLOC CO DYNALLOC UNALL GETTASK TASK CO OPEN DISK 160 HOBTEXT MVS MVS MVS MVS MVS MVS MVS MVS HOBTEXT HOBTEXT MVS HOBTEXT HOBTEXT MVS MVS MVS MVS MVS MVS MVS MVS MVS HOBTEXT MVS MVS MVS MVS MVS MVS HOBTEXT HOB under MVS and OS 390 A APPENDIX CO OPEN TCPIP TELNET PORT CO CLOSE TCPIP TELNET CO SHUTDOWN CO TCTLOAD PHASE CO HELP COM CO HELP COM FULL MVS HOB MVS MVS MVS MVS MVS HOBTEXT HOBTEXT 161 APPENDIX HOBCOM under MVS OS 390 A 7 HOBCOM PROGRAM PARAMETERS AGO PR3287 PR3770 ALARM auroconn AUTOEND b 1 0 0 01 7 PR3287 PR3770 P COBA DELAY EXTCHAR PR3287 FREEPAGE E PR3287 FREETIME PR3287 770 HIGHIN ff NOTE INVERS NOTE KEYLOCK LLM 22 1 PR3287 LOGMODE PR3287 770 MOVSP PR3770 MSG PR3770 NOATT pie PR3287 woema 5 NOTE NOSTAT NUMERIC OUTFILE PR3287 PR3770 PAGE 222 4 PR3287 PAPPL PR3287 PR3770 PARAM PR3287 PR3770 P
36. CONNECTIONS TO HOBCOM If the clients are connected over TN370E both display sessions and printer sessions are possible 9 3 1 TN3270E Display Session to HOBCOM S Session Sample configuration in HOBLink 3270 Configure Connections 06 HOBCOM under MVS OS 390 HOBCOM AND TCP IP TN 3270 x Cancel Terminal Device 3279 v Help Remote 5025 Auto Reconnect Host IP Address 23 45 123 123 Local Port Automatic Port Assignment Port 256 Use TN3270 Extended Protocol Resource Device Name TERM 23 9 3 2 TN3270E Printer Session to HOBCOM S Session If you are connected to HOBCOM with a TN3270E printer session the emulation can be interpreted by MVS HOBCOM as 5 printer HOBCOM supports then both DSC print and SCS print That means that it is possible to address an S printer out of HOBCOM with 3270 data stream Therefore in VM HOB COM the driver 0100 has been linked An entry with the macro XCTPRI is not mandatory for the TN3270E The TN3270E connection requires the authorization for S sessions through a HOBCOM password After the session to HOBCOM was built up the session gets inside HOBCOM the name that was en tered in the TN3270E application as device name or resource name This name was sent inside the data stream If no device or resource name was entered a
37. D4B32782 can be used If the terminal is to be connected to a SNA unit use one of the following entries D4A32782 D4C32782 or D6327802 Use the entry which corresponds to your control unit If you want a different report format as the standard model 2 the last place of the logmode has to be fit accordingly Example D4C32782 stands for model 2 D4C32875 stands for model 5 9 DEFINING TERMINALS AND PRINTERS HOBCOM under MVS and OS 390 3 2 2 USSTAB for SNA bzw NON SNA Terminals Five different USSTAB enties are listed in the appendix choose the appropriate one and assemble it These USSTAB entries are part of the HOBCOM installaton tape see chapter 2 The USSTAB requires that a distinction be made between terminals connected to an SNA control unit and NON SNA control unit A NON SNA control unit is indicated as type A A in second position of the terminal status line An SNA control unit is indicated as type B B in second position of the terminal status line The display printer adapter of the 4321 4331 or 4361 CPUs is handled as a NON SNA control unit An example is given for each type of control unit one with immediate shut off and one with delayed shut off When using an SNA control unit please note the following The parameter specification LOGAPPL HOBCOM in the VTAM table causes the terminal to be connec ted to the HOBCOM application when HOBCOM is started The session will not be started if VTAM Versi
38. F Wrong character type TERMINAL ERROR H entry length incorrect TERMINAL ERROR I the cursor is not in a defined data field 122 HOBCOM under 5 OS 390 MESSAGES TERMINAL ERROR J 2 windows sent XCTE0031 ID xxxxxxxx TERMINAL DATA ILLOGIC Terminal xxxxxxxx has sent illogical data to HOBCOM Contact HOB oftware Service XCTMO0040 ID xxxxxxxx ERROR OUTPUT FORMAT Internal HOBCOM error the output format of a virtual screen is ncorrect Contact HOB Software Service XCTEO0041 ID xxxxxxxx NO SCREEN TO OUTPUT HOBCOM has made several unsuccessful attempts to process a irtual screen for output This may be due to the fact that HOBCOM is running with a very low priority or it may be due to an internal HOBCOM error Contact HOB Software Service XCTEO042 ID xxxxxxxx SCREEN HAS ERROR Internal HOBCOM error the output of a virtual screen is incorrect Contact HOB Software Ser vice XCTE0043 ID xxxxxxxx OUTPUT HAS INVALID SCREEN FORMAT Internal HOBCOM error the output of a virtual screen in HOB mode is incorrect Contact HOB Software Service XCTE0044 ID xxx OUTPUT HOB MODUS HAS ERROR The program you invoked uses a screen format which is not supported by your machine Choo se a suitable screen format XCTM0050 ID xxxxxxxx LOG ERR RTNCDzxx FDKB2 xx SENSE XXXXXXxxx An error was indicated while logging on a real terminal xxxxxxxx Refer to the VTAM manual VTAM Programming in particular
39. FOR NON SNA CONTROLLER PRINT NOGEN 055 1 USSTAB LOGON USSCMD CMD LOGON FORMAT PL1 SSPARM PARM APPLID SSPARM PARM LOGMODE DEFAULT S3270 R D R SSPARM PARM DATA SSCMD CMD IBMTEST FORMAT BAL SSPARM PARM P1 DEFAULT 10 SSPARM PARM P2 DEFAULT 0123456789ABCD SSMSG MSG 10 BUFFER PTEXTA SSEND DC AL2 PTE LENGTH I DC XE DC X C3 DC X 114040C1 DC X FO6FAC6FEF X F6FO5BEO X 00115D7F40 WRITE OUTPUT ERMINAL WITCH OUT CODE ONCE LANK AT THE END D UC QU X zx zZ 165 APPENDIX HOBCOM under MVS OS 390 TITLE USSTABN2 HOBCOM USSTAB FOR NON SNA CONTROLLER PRINT NOGEN USSTABN2 USSTAB LOGON USSCMD CMD LOGON FORMAT PL1 USSPARM PARM APPLID USSPARM PARM LOGMODE DEFAULT S3270 USSPARM PARM DATA SSCMD CMD IBMTEST FORMAT BAL SSPARM PARM P1 DEFAULT 10 SSPARM PARM P2 DEFAULT 0123456789ABCD SSMSG MSG 10 BUFFER PTEXTA SSEND DC 12 PT EXTA 2 LENGTH DC X F5 ERASE WRIT DC X C3 WCC DC X 114040C1 BEGINNING OUTPUT DC X FO6FACEFEF OF TERMINAL DC X F16F6A506F6F6F4C7C5B6F COMMAND SI DC C HOBCOM NICHT VERF TEX DC X CO7B SIGN U DC C GBAR X F6F86F7B SWITCH OFF CODE DELAYED X
40. HOBCOM differs from the protocol that the user uses for the communication with HOBCOM E Protocol An identification isn t necessary by announcing on HOBCOM In several HOBCOM programs e g itis an identification necessary io HOB 5 05 390 Creating termnial and usergroups Y Protocol An identification is required by announcing on HOBCOM But there exists the possibility to deposit use rid and password on the client so that an identification happens automatically An identification of the user isn t necessary in any HOBCOM program like STTE see above S Protocol and X Protocol The system administrator has to define how the announcing on HOBCOM take place You find more information in the paragraph 6 11 LOGON MASK BY S AND X SCREENS XCSYSCTL on page 65 HOB TERMINAL CONTROL TABLE FOR HOBCOM 6 TERMINAL CONTROL TABLE FOR HOBCOM 6 1 TABLE STRUCTURE The Terminal Control Table is needed to manage the terminals under HOBCOM HOBCOM under MVS and OS 390 In addition to the terminal entries it contains information on the HOBCOM printers and the different form definitions for print output The offers more comfort when using HOBCOM you can enhance the layout of the HOBCOM opening panel define abbreviations for the commands and enter commands to automatically start and stop HOBCOM tasks The XCTCT consists of several individual tables and st
41. SHR XCJCL2J XCJCL2E DC AL2 0 Instead of SFILE VSAMT1 you have to write the name under which the file is stored in the system while for FILEO1 the name that is to be valid in HOBTEXT has to be entered FILEO1 SFILE1 VSAM CAT CATx ENT DISK In the DLBL Statement the system name of the file SFILE1 and the file name that will be used in HOB TEXT FILEO1 are given Instead of CATx the name of the VSAM catalogue must stand in which the file is listed instead of DISK the name of the disk on which the file is stored 10 8 PDS With the driver routine SPDS information can be read into HOBTEXT out of partitioned data sets 1 part filename fix PDS The second part filename marks the data set name in the XCTCT NAME The third part filename contains the actual member name Since this name is not given in the XCTCT any chosen member of a library can be read as long as it is defined as partitioned data set in the XCTCT Example the member in the partitioned data set CODIS LIB1 should be read In the XCTCT is defined XCJCLTAB DS OF JCL EINTRAGE XCJCL2 NAME CODL CODD DSN HOBCOM LIB1 DISP SHR VOL SER DISKO1 XCJCL2J XCJCL2E DC AL2 0 The contents can now be read with the file names PDS CODL MODTABCX An enlargement that enables writing is possible when necessary Up to now write ac
42. be started automatically through an entry in the HOBCOM TCT XCUBT Macro or individually with help of the COBA program 8 6 2 Output over the HOBCOM Notebook The NOTE program can also be invoked as ONLINE task with the help of the command EXEC NOTE order or a corresponding command abbreviation You can choose between 5 options in a terminal mask One of these options allows the storing and later printing of up to 8 terminal contents For further information see the HOBCOM User s Manual 8 7 PRINTING FROM HOBCOM OVER For Information about printing from HOBCOM over TCP IP please refer to chapter 9 HOBCOM AND TCP IP on page 92 HOB HOBCOM under MVS and OS 390 9 HOBCOM AND TCP IP HOBCOM supports the following three TCP IP applications Connecting PCs with HOBCOM over TN3270 or TN3270E e Printing on LPD Printing on NCs In HOBCOM a Lineprinter Requester is integrated which allows you to print on LPD If a PC is connected to HOBCOM over TN3270 the PC can only open a display session If a PC is con nected over TN3270E a display session or a printer session can be opened If the PC is connected with HOBLink 3270 or HOBLink J Term the PC performs with one session display session and printer session concurrently In this case TN3270E is used always print data and screen data are sent to the same resource name If you are using TN3270E screen or printer or TN3270 only
43. entry is 2 digit numeric and refers to the table containing the printer types starting at the label XCPRTAB The last two settings of the printer type are to be entered here The 3270 terminals are defined with the macro XCTSTE ERM terminalname FLAG flag terminalname As terminal name enter the name that has been registered in VTAM for the real terminal flag The following etries are possible as flags OPT optimized data transmission NOMDREAD modified fields are not read again when the program questions them FULLREAD sets up READ BUFFER disadvantage more data is send over the li nes This entry is necessary when terminal logs on with a command that contains the parameter data s 3270 printers are defined with the help of the macro XCTPRI XCTPRI TERM terminalname PRINT 0100 T HOB HOBCOM under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM terminalname as terminal name enter the name that is given in VTAM for the real printer 0100 The print driver 100 is absolutely necessary at this time ben The last terminal of the series i e E terminals standard 3270 terminals and 3270 printers is entered with LASTTE YES Example OF ERM NO1 PRINT 10 ERM S01 FLAG OPT ERM P01 PRINT 100 ERM N02 PRINT 06 LASTTE NOn and S01 are real terminal names and P01 is a printer name as defined in VTAM You will find possi ble prin
44. for group 1 are defined under the label GIUSSCOM and those for group 2 can be found under the label G2USSCOM Under the label XCTEGRO the masks and the commands to be used for the individual terminal groups are entered as well as any additional HOBCOM Operator commands which are to be permitted in this group In our example the DISPLAY command has been entered for all terminals Additionaly terminals belonging to group 1 G1LABEL are authorized to use the commands CP as well as DISCTASK Entries for masks command abbreviations and any additonaly permitted Operator commands are optio nal If they are missing HOBCOM uses the standard entries contained in XCUSSOUT and XCUSSCOM respectively You can tell which group a terminal belongs to by the system message displayed in the part of the HOBCOM base mask that appears independent of the XCUSSOUT GxUSSOUT definitions Please be careful to make your entries in the proper order You can change the mask and commands for group 1 according to your wishes Groups and masks are not limited to 2 likewise you can also increase the number of terminals per group HOB 149 APPENDIX HOBCOM under MVS OS 390 TITLE XCTCT TERMINAL CONTROL TABLE HOBCOM XTCTDEF DEFINITION DATA FIELD ckckckckckck ck ckokckc
45. g GENCB was incorrectly terminated with the Return Code xx Refer to the VTAM Manual VTAM Messages Chapter Return Code Sense Fields and Return Code Posting Return Code Combination to find the cause of the error or inform the HOB Cu stomer Service ERROR 010027 INVALID CHARACTER IN PAGE The value entered after parameter PAGE is incorrect Refer to the Print Manual for a list of valid entries ERROR 010028 VALUE OF PAGE OUT OF RANGE The value entered after parameter PAGE is too large It must not exceed 999 ERROR 010029 PARAMETER FREETIME IS INVALID The value specified after the FREETIME parameter is incorrect Valid entries range from 1 to 9999 ERROR PR010030 PARAMETER 2 IS INVALID The value for FREETIME may not be null zero ERROR PR010031 You can build your own Exit Routines into your XCTCT that give back error codes These are put out under these error numbers ERROR PR010032 PAPPL xxxxxxxx NOT IN SESSION LOGOFF can only be performed when a session is established ERROR PR010033 NO SESSION EXISTS You can enter this command only when a session is established ERROR PR010034 LOGOFF ALREADY ISSUED You entered LOGOFF although the LOGOFF was already ended 136 HOBCOM under 5 OS 390 MESSAGES ERROR PR010035 SESSION IN SHUTDOWN STATE The Shutdown is not yet ended Wait a moment and try it again If the message is shown again please
46. given partition using the UNLOAD com mand although no program had been loaded by LOAD in the partition concerned Check whether a program is running at all in the specified partition If there is check how the program is to be terminated PROGRAM UNLOAD ALREADY ACTIVE An UNLOAD command has been entered although UNLOAD is already active Wait until the UNLOAD command has been executed WRONG TEXT AFTER COMMAND A text has been entered after one of the following commands UNBATCH UNLOAD CANCEL or LOGOFF The command must be entered withoutsubsequent text NO PROGRAM RUNNING IN SPECIFIED PARTITION The user has attempted to terminate the program in the given partition although no program is running in the partition concerned Check which partition is to be terminated Correct the partition number if necessary SPECIFIED PROGRAM HAS NO CANCEL EXIT The user has attemped to terminate a program that does not have a cancel exit The program must be terminated in the usual manner NO COMMAND ENTERED The ENTER key has been pressed without entering a command Enter a command INVALID COMMAND An invalid command has been entered Enter a valid command NO PROGRAM NAME ENTE RED The ENTER key has been pressed after the command EXEC without entering the program name Enter a valid program name after EXEC 118 under 5 OS 390 MESSAGES NO PROGRAM NAME GIVEN Enter or DatFreig key typed
47. name of the user s profile specifies the binder name of the user s profile specifies the text name of the user s profile The following entries have a meaning only for HOBTEXT MAILID1 MAILID2 MAILOD1 MAILOD2 COMASK specifies the cabinet name of the users mail entry specifies the binder name of the users mail outlet specifies the cabinet name of the users mail entry specifies the binder name of the users mail outlet gives the authorization for certain HOBCOM Operator Commands possible commands are SHU CAN DISC FILE TCTL TEXT CP Please note that every group in HOBTEXT and HOBLIST also has to be registered The necessary statements are NO group_number TYPE G and NAME group_name 64 under MVS and OS 390 TERMINAL CONTROL TABLE FOR HOBCOM 6 11 LOGON MASK BY S AND X SCREENS XCSYSCTL In the table XCSYSCTL you define how the announcement on HOBCOM happens when user logon with a X or S Screen repectively emulation on HOBCOM In the table XCSYSCTL the macro XCSYSCTL is called XCSYSCTL DS OF XCSYSCTL PE PERSEXA YES NO With the parameter PERSEXA you define how user of terminals or terminal emulations logon on HOBCOM when the communication happens over the S or X Protocol YES When the user logon they receive a logon mask where they have to state user id and password If RACF is in use it checks the input before the connection with HOBCOM takes place NO
48. out by HOBCOM i e in program CO APPCVT ERROR 005 EXIT R here follows the message Storage Request When you need storage you must jump into a routine whose beginning address is in field SA STGET SA STGP or SA STGHP Storage Get SA STGET normal storage i e storage will be soon accessible again SA STGP permanent sto rage i e storage will be accessible at a much later time SA STGHP high priority storage i e only short pieces of storage should be asked for that are al ways needed by the system The registers are used as follows R13 addresses the SA BLOCK R12 contains the length of the desired storage at jump in The lenght must be devisible by 4 full words The address of the reserved storage will be reported back R14 contains the jump back address R15 contains the jump in addresse SA STGET or SA STGP SA STGHP The registers ROO and RO1 may be changed all other registers remain unchanged Should this storage be freed again you must jump into a routine whose beginning address is stored in the field SA STFRE Storage Free It makes no difference with which routine the storage has been re quested The registers are used as follows R13 addresses the SA BLOCK R12 contains the storage address that should be freed at jump in Exactly this address must first have been transfered at getting storage 5 5 R14 contains the jump back address R15 contains the jump in address SA STFRE The r
49. possible when the terminal is not entered in the CICS TCT 3 6 1 1 Definition in the CICS TCT The virtual terminals must be listed in the Terminal Control Table TCT It is not necessary to define the real terminal Using the parameter NETNAME you specify the name of the virtual terminal as it is defined in VTAM DFHTCT TYPE ERMINAL ACCMETH VTAM RMTYPE LUTYPE2 TRMMODL 2 FEATURE DCKYBD GMMSG YES PGESTAT PAGE PGESIZE 24 80 TCTUAL 255 TIOAI 048 4096 RUSIZE 2560 CHNASSY YES RELRE NO YES RMS TRANSCEIVE RMIDN oq 011 TRMPRTY E E Ila N K S TN rH X X X X X X X X X X X X X X X X The virtual terminals are defined as LUTYPE 2 Using the parameter TCTUAL you specify the same value used in your installation If you want to allow different screen models you must explicitely enter this HOB s DEFINING TERMINALS AND PRINTERS HOBCOM under MVS and 05 390 Example for model 5 DFHTCT TYPE TERMINAL ACCMETH VTAM TRMTYPE LUTYPE2 FEATURE DCKYBD GMMSG YES PGESTAT PAGE PGESIZE 24 80 TCTUAL 255 TIOAL 2048 4096 DEFSCRN 24 80 ALTSCRN 27 132 RUSIZE 2560 BUFFER 1532 CHNASSY YES RELREQ NO YES RMSTAT TRANSCEIVE RMIDNT NO22 ETNAME NO22 TRMPRTY 0
50. respectively FSP10 72 lines page and 10 characters inch 80 and 132 characters per line respectively FSP10H 72 lines page and 10 characters inch 80 and 132 characters per line respectively and hex feature that means that hexadecimal characters can be passed to the printer FSP17 72 lines page and 17 characters per inch 132 and 217 characters per line respectively b Special parameters for the HOB 8 LP LASEREL elite type LASERLP line printer type LASERCU italic type FQUERT1 DIN 4 horizontal line printer type c Special parameters for the HOB 8 LP2 and the HOB 8 LPEZ2 HOBELITE elite type HOBLP line printer type HOBCU italic type FQUERT1 DIN 4 horizontal line printer type FQUERT2 DIN 4 horizontal courier type GOTHIC Gothic GOTHICCU Gothic italic type COURIER Courier type Special parameters for 3270 printer 3270Q 4 sized paper 297 x 210mm horizontal format 17 signs inch 3270H 4 sized paper 297 x 210mm vertical format 12 signs inch 5 TERMINAL CONTROL TABLE FOR HOBCOM under MVS and OS 390 Definition of further parameters You can create print parameters to implement forms to suit your own needs A print parameter is a character string with the following structure 1 Half word length of the entire parameter 8 bytes parameter name 1 Byte length of the following print record n Bytes print record 1 Byte length of the following print record n Bytes print reco
51. screen the S protocol is used If you are using TN3270E and HOBLink 3270 display and printer the Y protocol will be used Requirements for TN3270 TN3270E to MVS HOBCOM TCP IP for MVS TN3270 TN3270E capable application on the PC TCP IP on the PC Requirements for LPD printing with MVS HOBCOM for MVS e LPD Requirements for printing on NC from MVS HOBCOM TCP IP for MVS e NC with TCP IP connection 9 1 HOBCOM DEFINITIONS FOR THE TCP IP CONNECTION 9 1 1 Open and Close TCP IP Port In order to make the TCP IP connection to HOBCOM possible it is necessary to open a TCP IP port before On the console of the MVS HOBCOM a TCP IP port has to be opened You can choose any free port number F jobname OPEN TCPIP TELNET PORT 5025 Example for an open that will be performed automatically when is started o2 HOB HOBCOM under MVS OS 390 HOBCOM AND TCP IP XCUBT SYSTE ES COM OPEN TCPIP TELNET PORT 5025 Thus HOBCOM becomes a TCP IP application You can open as many ports for HOBCOM as you want You should use ports that are not reserved Ports that are already used by other programs e g port 23 cannot be opened by HOBCOM The port entry on the client side 3270 emulation has to correspond with the port opened in HOBCOM When the OPEN is made TCP IP has to be active already on the host If you close and reopen TCP IP it is not
52. session is built up to HOBCOM and no XCTPRI entry was made HOBCOM recognizes automatically the printer type and assigns the driver 100 to the printer No different driver can be used for this printer type 9 3 3 TN3270E Display and Printer Session to HOBCOM Y Session Requirement on the client side is HOBLink 3270 or HOBLink J Term and a password that allows you to use Y sessions Enable the HOBCOM support check box in the HOBLink 3270 configuration dialog box If you use HOBLink J Term choose the protocol The session is represented for HOBCOM as a terminal that can process both display and printer data as the terminals can do it Analogous to the terminal in HOBCOM printer task is created in the background e g PRVM HOBCOM under 5 OS 390 HOBCOM AND TCP IP The output of the printer data is made to this terminal i e with the parameter PRI or OUTFILE as printer name the device resource name is specified If no device resource name was specified the termi nal will obtain a HOBCOM name This name is TEL nnnn nnn is a number consecutive from 0001 up HOBLink 3270 can also establish a printer session to HOBCOM but this session will be executed like an S session If in the HOBLink 3270 printer session the HOBCOM support check box is enabled this device will be refused by HOBCOM as a 3270 printer cannot understand the Y protocol XCTERMT1 TCP SB 3270 REGIM
53. session name will be assigned automatically This name is TEL nnnn nnn is a number consecutive from 0001 up You cannot influence this number HOBCOM assigns it automatically If no device or resource name was entered the startup of printer tasks cannot be made automatically because the name of the TN3270E printer session is not fixed before The name of the TN3270E printer session can be displayed by the CO D TERM command in the HOB COM main mask or console The name of the printer session then can be specified in all print programs in the parameter PRI or OUTFILE as the destination of the print Examples EXEC PR3287 SA 01P PA CICS PRI TNS 0001 EXEC PR3287 SA 01P PA CICS OUTFILE SNET Sname TEL 0005 HOB 97 HOBCOM AND HOBCOM under MVS and OS 390 All print programs available in HOBCOM under MVS can be used That means that you can print out of CICS with PR3287 from JES with PR3770 over NOTE etc Sample configuration in HOBLink 3270 Configure Connections x LU Type Printer Use Session Next Available F Screen Size 80 24 Mo of Connections Connection 1 Connection 3270 X Configure Cancel E Help HOBCOM Support Host Graphics Support Acknowledge Timeout secs 10 m Auto connect time Disconnect after mins idle 0 3270 OK Host Alias IP Addr
54. string of the print record here The structure of a print record is de scribed below Structure of a Print Record The first byte of a print record contains the feed byte All values between X 00 and X 7F 0 to 127 are interpretted as the number of line feeds to be made before the first line is printed X 00 print without line feed X 01 print with normal line feed X 05 print with 5 blank lines between printed lines All values between X 80 and X FF 128 to 255 have special functions X 80 a page feed occurs before printing starts X 81 indicates that attributes are to passed on for the following lines Attributes can be set for each character The following attributes can be evaluated by the printer X 40 shadow print the characters are printed in shadow mode displayed on the screen as extra bright characters X 20 bold overprint the characters are printed as italics displayed as reverse video on the screen 10 underscore print the characters are underlined also displayed on the screen as underlined characters You can combine the attribute bits as you wish The printer driver routine evaluates the attributes accor dingly For example if you specify X 50 the characters will be printed in shadow print and underlined X 83 indicates that alpha characters with horizontal feed follow Alpha characters 40H and greater are printer without horizontal feed The feed is represented by the values 1 t
55. sufficient to perform a second OPEN A CLOSE has to be made before To do this enter on the console of MVS HOBCOM jobname CLOSE TELNET PORT 5025 9 1 2 Entries for TCP IP in the XCTCT An additional entry in the XCTCTGEN macro is required TCP IP XCTCPIP After making this entry you have to load the new macro library XCTCPIP and to assemble the XCTCT with this library Example XCTCTANF TERMA XCTI USSOUT XCUSSOUT USSCOM XCUSSCOM PRPAR XCPRPAR USSBTA XCUSSBT APPLTA VCAPPLT PERSTA VCPERS 5 5 PASSW XCPASSW X X X X X X X X X X The new table XCTCPIP is entered after an existing table e g after the endmark of VCPERSTA DS OF XCTCPIP NSERVER aaa bb ccc d VMTCPIP jobname DOMAIN domainname HOST hostname TIMEOUT 15 AL2 0 end mark of the table HOB HOBCOM AND HOBCOM under MVS and OS 390 aaa bb ccc d TCP IP address of the name server over which the destination addresses are called jobname name of the job in which the TCP IP socket is started It s an optional parameter but has to be entered when it s different to the default TCP IP jobname hostname the TCP IP name of the HOST in which HOBCOM runs domainname the name of the TCP IP domain in which the HOST hostname is located Ex
56. to HOBCOM laptops use the logmode ENTRYC It is described in the Modetab MODTABLT that you find in the appendix and on the installation tape 3 3 5 USSTAB for Laptops USSTABLT JOB JNM USSTABLT CLASS A DISP D LST DISP D CLASS C DEST SYSGE JOB USSTABLT EXEC PROC SPACEMGR LIBDEF PHASE CATALOG GEOLIB SYSLIB TEMP OPTION CATAL NODECK PHASE USSTABLT EXEC ASSEMBLY SIZE 128K TITLE USSTABLT NORMAL USSTAB FOR LAPTOP PRINT NOGEN USSTABLT USSTAB LTC1 USSCMD CMD LTC1 REP LOGON FORMAT PL1 USSPARM PARM APPLID DEFAULT HOBCMC1 LTC2 USSCMD CMD LTC2 REP LOGON FORMAT PL1 USSPARM PARM APPLID DEFAULT HOBCMC2 MESSAGES EQU USSMSG MSG 1 BUFFER MESSO1 WRONG FORMAT USSMSG MSG 2 BUFFER MESS02 COMMAND UNKNOWN USSMSG MSG 3 BUFFER MESS03 PARAMETER UNKNOWN USSMSG MSG 4 BUFFER MESS04 PARAMETER INVALID USSMSG MSG 5 BUFFER MESS05 FUNCION NOT SUPPORTED USSMSG MSG 6 BUFFER MESS06 SEQUENCE ERROR 7 B USSMSG MSG UFFER MESSO7 BIND REJECT PROM APL USSMSG MSG 8 BUFFER MESS08 INSUFFICIENT MAIN STORAG USSMSG MSG 12 BUFFER MESSOC OPERAND MISSING USSMSG MSG 13 BUFFER MESSOD VTAM ECHO Gl
57. two parameters for calling ERROR NOTE0004 INVALID OUTFILE FILE NAME The name given at parameter OUTFILE is wrong Compare the build up of the parameter in chap ter parameter at calling ERROR 0005 PRINTER IS INVALID The printer name entered cannot be found or no printer has been generated for the terminal spe cified A second possibility is that the REVP has not been started ERROR 0006 PRINTER PARAMETER NAME INVALID The printer parameter name entered could not be found in the table Check the XCTCT or the VCTCT to see if the parameter has been entered correctly ERROR 0007 PARAMETER TERMINAL ONLY IN BATCH TERMINAL was entered when invoking NOTE as a dialog program This parameter is only va lid for batch tasks ERROR NOTE0008 TERMINAL NOT FOUND The terminal entered after TERMINAL is not listed in the or VCTCT ERROR NOTE0009 TERMINAL NOT ACTIV The terminal entered with TERMINAL is not active ERROR 0010 HARDCOPY ALREADY DEFINED The hardcopy key can only be assigned to one program In this case the hardcopy key was dl ready defined by a preceding call ERROR NOTE0011 TASK DISCONNECTED BY TERMINAL A hardcopy is to be entered for a disconnected task First execute the command GETTASK for this task HOB MESSAGES HOBCOM under MVS and OS 390 ERROR NOTE0012 IN BATCH SOFTCOPY NOT ALLOWED Parameter SOFTCOPY was entered when invoking program NOTE fo
58. user has its own personal entry HOB DEFINING PCS WITH HOBLINK 3270 Y PROTOCOL HOBCOM under MVS and OS 390 Examples ERSTA DS OF For VSE MVS and GCS ERS NO 111111 TYPE P NAM EST PW GUEST ENKEY GUEST ENFULL NO XCPERS NO nnnnnn TYPE P NAME name PW password ENKEY key ENFULL NO YES INSTEAD ENKEY OPTIONALLY ENKEYH BE USED IHE KEY HAS BE ENTERED HEXADECIMALLY THEN EBCDIC EXAMPLE ENKEYH C7E4C5E2E3 GUEST ck ck kc Ck CK Ck Ck Ck Ck Ck CK Ck Ck CK Ck Ck CK Ck Ck Ck kk Ck CK Ck Ck Ck AK Ck Ck CK Ck Ck Ck Sk Ck Ck Ck Sk Ck Ck kk Sk Ck Sk Sk Pk A kx A Ax nnnnnn personal number The number 000000 is reserved and may not be used password the HOBCOM user password name HOBCOM user ID encryption key it may be chosen freely ENFULL NO only the passwords will be encrypted YES data will be encrypted XCPERSTA DS OF without RACF XCPERS NO nnnnnn TYPE P NAME name PW password PROFD1 HOB PROFD2 PROFILE PROFD3 name MATLID1 POSTEIN MAILID2 name MATLOD1 POSTAUS MAILOD2 nam NKEY key ENFULL NO with RACF PERS NO nnnnnn TYPE P NAMI ERID userid ROF
59. without typing a program name after the EXEC command PROGRAM NAME TOO LONG Either a program name with more than eight characters has been entered or no space has been left between the program name and subsequent parameters Enter a valid program name with up to eight characters PROGRAM DOES NOT EXIST The user has attempted to invoke a program that does not exist Enter a valid program PARTITONS PROGRAMS STILL ACTIVE The user has attempted to enter LOGOFF in the HOBCOM console although applications are still running in other virtual terminals Applications in progress must be terminated before ente ring LOGOFF NO COMMAND STORED Function key F5 or F6 has been pressed after switching on the terminal although no command has been entered and stored The first command and commands in general is stored after being entered and can then be repeated using the function keys F5 and F6 NO STORAGE SPACE AVAILABLE The main storage space managed by HOBCOM is full Increase the value of the SIZE statement for the partition or class in which HOBCOM is running Refer also to the installation description Section 5 PROGRAM CANNOT BE INVOKED BY EXEC The user has attempted to load program XC DA with the EXEC command The command LOAD XC DA must be entered to load program XC DA PROGRAM CANNOT BE INVOKED BY LOAD The user has entered LOAD to invoke a program that can only beinvoked by a different com mand Enter the corresp
60. 0 MODEE LOGMODE PS1920 FMPROF X 03 PRIPROT X B1 SECPROT X 90 COMPROT X 3080 RUSIZES X 8587 PSERVIC X 020000000000185000007E00 34 under MVS and OS 390 3 7 DEFINING THE VIRTUAL PRINTERS IN THE APPLICATIONS You can connect a HOB printer directly to your HOB E terminal If the printer is to be accessed via VTAM you must define it as an application in VTAM 3 7 1 Definition for the 3287 Emulation Using program PR3287 you can print directly from your applications on a HOBCOM printer However you must first define the HOBCOM printer in your applications 3 7 1 1 Definition in CICS In CICS you can specify the HOB printer as LUTYPE1 or LUTYPES Example of a LUTYPE 1 DFHTCT TYPE TERMINAL ACCMETH VTAM RMTYPE SCSPR TRMMODL 2 COMPAT NO ERRATT NO PGESIZE 24 80 PGESTAT AUTOPAGE TCTUAL 255 160 RE CE IVE NOIP ETNAME NO1P PRTY 0 Example of a LUTYPE 3 DFHTCT TYPE T ACCME TRMTYPE PAT NO ERRATT NO ESIZE 24 80 ESTAT AUTOPAGE L 255 160 TRANSCE IDNT NOIP E NOIP PRTY 0 HOB xx PX KK PX PX PX PX X DEFINING TERMINALS AND PRINTERS 35 DEFINING TERMINALS AND PRINTERS HOBCOM under MVS and O
61. 31 3 7 DEFINING THE VIRTUAL PRINTERS IN THE 35 4 CONNECTING THE TERMINALS 38 4 1 REPLACING A TERMINAL WITH A esses 38 4 2 CONNECTING THE 38 4 3 CONNECTING TO 3174 CONTROL 38 4 4 CONNECTING TOKEN RING 5 39 5 Creating termnial and usergroups 40 In general tren eet o rne d tete ede ne ROME dade Ded e ee 40 5 2 Identification by announcing to ene rennes 40 6 TERMINAL CONTROL TABLE FOR HOBCOM 42 63 TABEE STR GTU LRE AER eee e ake Paden nah Rx ARDT 42 HOBCOM under MVS and OS 390 6 2 THE FOR nnn eren 43 6 3 TABLE WITH TERMINAL ENTRIES XCTERMA 44 6 4 TABLE WITH PRINTER TYPES XCPRTAB 47 6 5 GROUP ENTRIES FOR TERMINALS 49 6 6 SCREEN LAYOUT 55 51 6 7 TABLE WITH ABBREVIATIONS 5 enr 52 6 8 TABLE WITH PRINTER FORM DEFINITIONS 2 53 6 9 TABLE WITH BATCH TASK COMMANDS XCUSSBTA
62. 503 The process was not found x 504 A system call was interrupted x 505 An I O error occured x 506 The device or driver was not found x 507 The argument list is too long x 508 An EXEC format error occured x 509 Givesocket The socket has already been given The domain is not AF_INET Select One of the specified descriptor sets is an incorrect socket descriptor x 50A There are no children x 50B There are no more processes HOB 141 MESSAGES HOBCOM under MVS and OS 390 x 50C There is not enough storage x 50D Takesocket The other application listener did not give the to your application Socket Access denied The client s ID is not the OBEY file x 50E An incorrect storage address or length was specified x 50F A block device is required x 510 Listen has already been called for this socket x 511 The data set exists x 512 This is cross device link x 513 The specified device does not exist x 514 The specified directory is not a directory x 515 The specified directory is a directory x 516 An incorrect argument was specified x 517 Data set table overflow occurred 518 The socket descroptor table is full x 519 An incorrect device call was specified x 51A A text data set is busy x 51B The specified data set is too large 51 There is no space left on the device 510 An incorrect seek was attempted 51 The data set system is Read only x 51F There are too many links x 520 Th
63. 9 a resource is allocated 2 Part filename Class of the system printer in JES 3 Part filename any string with the maximum length of eight characters When U is registered the text is translated in capitals Please note that the output on Remote NJE isn t possible respectively the way over ROUTI is expected Example E PRINT x y EC PR3287 PA CICS SA NO1P OUTFILE SPRINT H XXX U PARAM FSP17 89 PRINTING WITH HOBCOM under MVS and OS 390 8 5 PRINTING A HARDCOPY ON E TERMINAL PRINTER The advantage of hardcopy printing over HOBCOM is control unit overlaping hardcopies are possible Please note If you are working on standard 3270 terminal the program NOTE cannot be started as a batch task because the terminal software does not allow it However a hardcopy can be routed from an E terminal to a standard 3270 terminal with an attached printer 8 5 1 Pressing the Hardcopy Key for Output To activate your hardcopy key the program NOTE as Batch task must be started over the COBA pro gram or through entering the XCTCT table XCUSSBTA ERM terminal name PRI printer nam terminal name of the terminal from which the hardcopy will be sent printer name Name of the terminals onto which the printer is connected on which the hardcopy will be put out The NOTE program can either be started automatically through an entry in the HOB
64. 90 0017 ID xxxxxxxx LOGON MESSAGE IGNORED Because of that the you are already logged in with your screen e g as E Screen your mes sage was ignored XCTMO0020 LU xxxxxxxx CLSDST ERROR RTNCD xx FDBK2 xx SE XXXXXXXX VTAM registers an error Consult the IBM manual VTAM Messages in particular the chapter on Return Codes Sense Fields and Return Code Posting XCTM0021 LU xxxxxxxx ERR R xx RTNCDzxx FDBK2 xx SENSEZXXxxxxxxx VTAM registers an error Consult the IBM manual VTAM Messages in particular the chapter on Return Codes Sense Fields and Return Code Posting XCTM0022 IDzxxxxxxxx ERR R xx RTNCDzxx FDBK2 xx VTAM registers an error Consult the IBM manual VTAM Messages in particular the chapter on Return Codes Sense Fields and Return Code Posting XCTM0023 ID xxxxxxxx NSEXIT NSH xxxxxx CLEANUP The session between and the terminal has been ended XCTEOO030 ID xxxxxxxx TERMINAL ERROR Terminal xxxxxxxx has sent an error message to HOBCOM Contact the Software Service The following is a list of possible errors TERMINAL ERROR A incorrect switch off instruction TERMINAL ERROR B wrong IDT Byte TERMINAL ERROR C the entry field defined does not begin on the terminal screen This means that the displacement of the entry field is not between 0 and 780H TERMINAL ERROR D wrong end address entry field is longer than the terminal screen TERMINAL ERROR E
65. ACB an error message was passed to PR3770 Consult the VTAM Manual Chapter Description of the VTAM Macros Instructions to find the cause of the error or inform the HOB Customer Service ERROR PR020019 PAPPL xxxxxxxx NOT DEFINED X The primary application entered e g POWER JES has not been defined ERROR 20020 PAPPL xxxxxxxx NOT ACTIVE The requested primary application application program e g POWER JES is not active and as a result cannot be reached ERROR 20021 LOGMODE NOT DEFINED The LOGMODE entered is not listed in your MODETAB Ask the system programmer for a valid LOGMODE HOB 139 MESSAGES HOBCOM under MVS and OS 390 ERROR PR020022 REQSESS xxH FTH xxH SENSE Request Session has been rejected For the meaning of the codes refer to the VTAM Manual VTAM Programming Appendix ERROR 020023 PAPPL BIND PARAM INVALID The primary application POWER or JES has sent the wrong BIND parameters for LOGON This may be due to an incorrect LOGMODE LOGON with LOGMODE Enter appropriate session parameters for LOGMODE ERROR 020024 LOGON REJECTED LOGON to the Primary Application has been rejected For the meaning of the codes refer to the VTAM Manual VTAM Programming Appendix B ERROR 020025 NO BIND OUT OF SERVICE The selected application does not send a Bind no connection is established This may be be cause
66. BCOM ASYNCRONOUS 3 3 1 General Remarks for an Installation We suggest the following steps for installation Apply for the NUI at Telekom early this takes the longest time Fit the NCP Load the HOBCOM installation tape Establish VTAM entries they can partly be found on the HOBCOM installation tape fit HOBCOM TCT with password start up HOBCOM fit the HOBLINK setup for HOBCOM asynchron DEFINING TERMINALS AND PRINTERS HOBCOM under MVS and OS 390 3 3 2 Entry in the NCP The entries for LLCLIST IDBLKP PAD and TRAN have a special meaning for the laptop Other than that the SVC lines that could be used are made available STAGE 1 OF THE X 25 E08 25 NETWORK IS DATAPAC DM YES LAPB DM IS USED CPHINDX 1 VCCPT INDEX 1 MAXPKTL 128 MAX PACKE VWINDOW 7 OUFT INDEX 1 MCH ADDRESS 008 LIA TO DATEX P NOD 0 15 NUMBER OF VC S FRMLGTH 131 LLCLIST LLCO LLC2 LLC3 LLC4 LLC5 LCNO NOTUSED IDBLKG 065 UMBER OF GAT IDBLKC 066 UMBER OF PCN IDBLKP 067 UMBER OF PAD MWINDOW 7 DLC WINDOW 5121 U A A NPRETRY 10 MBER TIMEOUT RECOV PAD INTEG D SUPPORT INTEGRATED GATE GENERAL PAD CAN SEND INTERRUPT PACK STATION DTE NCP PORT WILL OPERATE AS DTI SPEED 64000 TRANSLATION FOR LAPTOP TPTIMER 3 TIMER
67. BTPRI and PERSNO that allow you to start batch tasks depen ding on the user name instead of the terminal name The BTPRI parameter allows you to store the information which terminal name has been started by this task The terminal name can be generated by HOBCOM If the parameter PRI is not set when invoking the print program the storage position will be read that was filled by BTPRI YES If you use the PRI parameter instead of the OUTFILE outfile parameter when you invoke the print gram the three part names of the OUTFILE parameter will be prooved That means that the terminal name on which the print will be made has to be known before Thus with the OUTFILE parameter a resource name has to be sent but not with the PRI parameter The PERSNO parameter in the XCUBT macro causes that a batch task will be started that depends on the user ID Example fo starting a batch task depending on a User ID It is possible to start a batch task that performs the print on the terminal on which the concerning per son logged on Example HOB 107 AND HOBCOM under MVS and OS 390 ERS NO 00000055 TYPE P AME MILLER PW PASSWORD ENKEY KEY ENFULL YES COMASK TEXT CP SHU CAN DISC FILE TCTL STTE XCUBT TASK HUGO PERSNO 00000055 BTPRI YE COM EXEC PR3287 SA sapplname If the person Miller logs on via HOBLink J Term withou
68. COM TCT XCUBT Macro or individually with help of the COBA program 8 5 2 Output over the HOBCOM Notebook The NOTE program can also be invoked as ONLINE task with the help of the command EXEC NOTE order or a corresponding command abbreviation You can choose between 5 options in a terminal mask One of these options allows the storing and later printing of up to 8 terminal contents For further information see the HOBCOM User s Manual 8 6 PRINTING A LOCAL HARDCOPY ON E TERMINAL PRINTERS The advantage of hardcopy printing over HOBCOM is control unit overlaping hardcopies are possible INFORMATION When you work on a standard 3270 terminal the PROGRAM NOTE can t be started as batch task because the terminalsoftware forbids it From an E Terminal the hardcopy can be transferred to standard 3270 terminal with printer In the terminal setup the hardcopy control has to be set to HOBCOM HOBCOM under MVS OS 390 PRINTING WITH HOBCOM 8 6 1 Output by pushing the hardcopy key To activate your hardcopy key the program NOTE as Batch task must be started over the COBA pro gram or through entering the XCTCT tabel XCUSSBTA ERM terminal name PRI printer nam terminal name Name of the terminal from which the hardcopy will be sent printer name me of the terminals onto which the printer is connected on which the hardcopy will be put out The NOTE program can either
69. COM TCT over the macro XCTCPIP Example XCTCTANF XTCTGE ERMA XCTERMA PRTAB XCPRTAB TEGRO XCTEGRO SSOUT XCUSSOUT USSCOM XCUSSCOM PRPAR XCPRPAR USSBTA XCUSSBTA JCLTAB XCJCLTAB DIANAM XCDIANAM COMASK XCCOMASK PASSW XCPASSW x MxM KM 27 DEFINING TERMINALS AND PRINTERS HOBCOM under MVS and OS 390 The new table XCTCPIP has to be added after a table that already exists e g under the END mark of XCDIANAM XCTCPIP DS OF XCTCPIP NSERVER aaa bb ccc d JNTCPIP jobname DOMAIN domainname HOST hostname TIMEOUT 15 12 0 End mark of the table aaa bb ccc d TCP IP address of the name server The parameter NSERVER is only necessary if HOBCOM is to print on print clients For printing over HOBLink 3270 using the Y protocol this entry is not necessary because the session is built HOBCOM here Jobname Name of the JOB that has started TCP IP This parameter is optional but if the job name is not TCPIP it has to be entered hostname the TCP IP name of the host which executes HOBCOM This parameter is optional Domainname the name of the TCP IP domain in which the hsot hostname is located This parameter is optional In order to create a TN3270 session to HOBCOM the authorization for using S sessions or Y sessions is required This authorization is granted over a HOBCOM pass
70. D on the host to HOBCOM both TCP IP and an LPD have to be installed on the host In the LPD a printer has to be configured in the LPD Lpr s eee ff ggg hhh p printername filenam 9 5 Printing on NC To print on a NC network client the programs NOTE PR3287 PR3770 can be used i e all programs that use the OUTFILE parameter The print is initialized from the host i e the NC is called over its IP number The NC can as LPD be called with or without driver 1 Printing without driver For LPD EC programname HOST ip address PRI name For NC HOB 105 AND HOBCOM under MVS and OS 390 programname HOST ip address PORT portnumber name is the name of the printer on the remote system PC portnumber is the port number the printer has on the remote system When you print on an NC you have to specify the port number In the XCTCT no entry is required if you want to print without driver 2 Printing with driver LPD EC programname HOST ip address PRI name EC programmname HOST ip address PRI name ip adress is the TCP IP address decimally or the IP name of the host name is the name of the printer as specified in the parameter in the XCPRT macro If a HOBCOM driver is used the NC print LPD print don t differ in their program invoke The printer has to be specified in the XCTCT in t
71. D1 HOB PROFD2 PROFILE PROFD3 name LID1 POSTEIN MAILID2 nam LOD1 POSTAUS MAILOD2 nam NKEY schl ssel ENFULL YES The personal entries in HOBCOM have to correspond with the entries in the configuration files hik of HOBLink 3270 One of the hlk values Name HobcomUserld or PersNo see default value of the file will be sent by HOBLink 3270 to HOBCOM for identification HobcomUserld will only be sent to HOBCOM if RACF is used PersNo will only be sent to HOBCOM if the entry is missing The hlk values Password and HobcomKey will always be sent to HOBCOM HOBCOM checks the core spondance of the sent values with the entries in the HOBCOM TCT If the entries don t correspond or if the maximum numbers of allowed Y sessions is exceeded the user is refused by HOBCOM HOB HOBCOM under MVS OS 390 DEFINING PCS WITH HOBLINK 3270 Y PROTOCOL Default values in the HOBLink 3270 configuration file hik Hobcom Yes HobcomKey C7E4C5E2E3 is always exploited by HOBCOM PassEncryption Off HobcomBigBuffer On Name GUEST Password GUEST is always exploited by HOBCOM HobcomUserId only required for RACF PersNo 111111 only reuquired if Name is missing If RACF is used If RACF is used in the HOBCOM TCT the parameter USERID has to be used instead of PW If HOBLink 3270 uses RACF when connecting an application the entry H
72. E TERMINAL NOT SUPPORTED Sample configuration in HOBLink 3270 DEZ E 2 konfigurieren 20 HP Laser Jet codepage P ENCRYPTIONKEY HOB 101 AND HOBCOM under MVS and OS 390 9 4 PRINTING OVER LPD 9 4 1 Printing from HOBCOM to an LPD In order to print over TCP IP out of MVS HOBCOM to an LPD some additional entries are required Entry in the XCTCT In the XCTCT an additional entry in the XTCTGEN macro is required See section 9 1 DEFI NITIONS FOR THE TCP IP CONNECTION on page 92 Therefore it is neccesary that you load the macro library XCTCTM that comes with HOBCOM and as semble the XCTCT with this library In the table XCTCPIP for LPD an entry can be made This makes it easier to address the printer on the target host This can be done with the XCHOST and XCPRT macros These macros are optional i e not required for printing on LPD XCTCPIP DS OF XCHOST NAME namel IPADDR eee ff ggg hhh XCHOST NAME name2 IPADDR eee ff ggg iii XCPRT NAME Sprinteralias PRT printername AL2 0 End mark of the table The XCHOST macro makes it possible to give the target host an alias name name2 Name that can be used at the parameter OUTFILE instead of the hex coded target address If you prefer the work with names instead of TCP IP addresses you can enter several names with its IP addresses under the XCHOST macr
73. ED B PEXROK READY DS OH ENTRY OCCUPIED LA R15 PEXEA ADDRESS ERROR MESSAGE B PEXRERR ERROR JUMP BACK DS OH PICK FROM POOL LA 4 1 ADDRESS FIRST ENTRY ICM RHO 15 SASUPNAT GET ADDRESS OF INTERIM STORAGE 2 18 7 FOUND XR 1 1 UNTIL YET ENTRY FOUND DS OH TABLE RH2 4 RH0 HERE ENTRIES LH RH3 2 RH0 NUMBER OF ENTRIES DS OH LOOK WHETHER IN TABLE CLC 0 8 RH2 O RHA THIS ENTRY BE PEXP10 H YE LTR RH1 RH1 SEARCH FREE ENTRY BNZ PEXPO6 CLI 0 RH2 0 ENTRY FREE PEXPO6 H NO LR RH1 RH2 REMEMBER ENTRY DS OH MEMBER PROCESSED LA RH2 8 RH2 NEXT ENTRY BCT 4 CONTINUE SEARCHING MVC 8 8 0 RH4 IHIS NAME PASSED LTR RH1 RH1 FREE ENTRY FOUND 2 40 7 0 8 RH1 0 RHA NOTE ENTRY OCCUPIED B PEXROK READY HOB under MVS and OS 390 PEXP10 12 18 20 40 PEXOUT 02
74. ERM PR3287 3770 PF PRINTER PR3287 PR3770 SAPPL PR3287 PR3770 SFN3 287___ PR3770 sorroopy NOTE TERMINAL fe NOTE upc UNDERLINE NOTE 162 under MVS OS 390 A APPENDIX A 8 HOBCOM PRINT PROGRAM COMMANDS ATTENT PR3287 PR3770 CANCEL PR3770 GO PR3770 HALT PR3770 LOGON PR3770 LOGOFF PR3770 MESSAGE o PR3770 QUERYPARAM SEND PR3770 PR3770 SETPARAM SETCONSOLE 3770 SHUTDOWN PR3287 PR3770 HOB 163 APPENDIX 9 HOBCOM MODETABS TITLE MODTABCX HOBLMEO2 D4C32782 D6327802 CODLOG10 USSTABCO ENTRYC D4C32782 DSILGMOD MODI PRIN MOD MOD NOGEN ETAB EENT LOGMOD E HOBLMEO2 FMPROF X PRIPROT COMPROT PSERVIC ENT LOGMOD 03 TSP ETAB FOR HOB TERMINALS ROF X 03 X Bl SECPROT X 90 X 3080 X 028000 E D4C327 82 PSERVIC ENT LOGMOD TSP RUSIZI ROF X 03 X B1 SECPROT X 90 X 3080 X 028000 E D63278 02 FMPROF X PRIPROT COMPROT PSERVIC ENT LOGMOD 103 5 RUSIZI ROF X 03 X Bl SECPROT X 90 x 3080 X 028000 E CODLOG10 FMPROF X PRIPROT COMPROT
75. EXT or HOBLIST Please note that at the moment we have no program that passes on files that are on disks to a printer The FAX output will also be stored onto disks only with FAX option SPOOL puts the list onto disks in HOBLIST format looking at it with EDLI is possible HOBTEXT modul HOBLIST 1 part filename fix SPOOL The second part filename will give the name of the terminal onto which the chosen printer will be connec ted If the printing should be done on disk the terminal name is still to be entered this name then serves as binder name for the archives The third part filename can be chosen out of the following options NORMAL ormal printing when the printer is occupied the user must wait until the printer is either free and the output is ended DIRECT directly onto terminal printer when the printer is occupied an error report will be given and the printing is interrupted PERM terminal printer permanently appointed IMM immediate print when the printer is occupied the print output is detoured onto disk Eintrag aus XCJCLTAB print onto disk Notice to printing on disks In the HOBCOM TCT the Macro XCJCL3 in the XCJCLTAB can be used to steer the output onto disk LTAB DS OF 3 NAME name DISP H CLASS F PRI 7 SPFIL3 TSP You enter a random maximally 8 digit string as a name we suggest SPOOL Disposition DISP class CLASS and Printer PRI are not evaluatedat the moment The
76. GRUPPEI DC 66X 0B HORIZONTAL LINE DC X 42 CORNER DC X 46 VERTICAL LINE DC 2X 40 DC CL76 The following commands can be entered DC X 46 VERTICAL LINE DC X 46 VERTICAL LINE DC 5x 40 DC DC X 46 VERTICAL LINE T HOS HOBCOM under MVS OS 390 A APPENDIX DC X 46 VERTICAL LINE DC 5x 40 DC CL73 DC 46 VERTICAL LINE DC X 46 VERTICAL LINE DC 5 40 DC CL73 VM CMS MASCHINE DC 46 VERTICAL LINE DC X 46 VERTICAL LINE DC 5 40 DC CL73 AUS SWITCH OFF TERMINAL DC x 46 VERTICAL LINE DC 02 CORNER DC 78X 0B HORIZONTAL LINE DC x 43 CORNER G2USSOUT DS OF OUTPUT DC AL2 xxx LENGTH OF OUTPUT Mask for group 2 XCUSSOUT DS OF DC 12 LENGTH OF OUTPUT Standard mask for those terminals which have not been assigned to a group in XCTERMA XCUSSCOM EQU COMMANDS XUCUSS X abbreviations for terminals not assigned to a group diplayed in the standard mask DC CERA END OF TABLE G1USSCOM EQU COMMANDS XCUSS ABB PROD X COM EXEC COVTOP PA PRODCICS KEYLOCK XCUSS ABB AUS x COM LOGOFF DC X FF END OF TABLE G2USSCOM EQU COMMANDS quaque pales X starting here you can define the abbreviations for the commands to be used for group 2 make s
77. HOBCOM to prepare input like LOGON procedures This function is especially usefull for loggon over RACF through PASSTICKET With the help of Screen Mask you can query certain screen contents or parts of it in the TCT and cor responding to the picture you can order certain input 73 TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and OS 390 Not only characters in the screen display can be checked but also attributes As further criteria a special register is available for certain automatically input Every Screen Mask has a name length of eight byte in the HOBCOM TCT Inside a Screen Mask entry Several screen contents can be described that means you can switch through several masks If the de scription fits on a present screen the fields can be filled and an application can be sent Tip For a better using of RACF passticket the application HOBCOM has to be particularly authorized that means it has to be catalogized with SETCOD 1 in an authorized library Besides the RACF interface in HOBCOM has to be activated per ZAP The person who wants to logon has to be defined in the HOBCOM TCT with XCPERS Instead of the parameter PW the parameter USER is stated 6 16 1 Installation of Screen Mask a SMD BLOK is tendered for one s resignation in the XCTCT COPY SMDSBLOK b the macro XCTCTANF has a new parameter XCTCTANF SCRMA XCSCRMA the new table XCSCRMA is inserted at the right place in the XCTCTt be
78. IND para meters Therefore you must make certain that in the definition of the virtual terminals in VTAM you have HOB DEFINING TERMINALS AND PRINTERS HOBCOM under MVS and OS 390 specified the correct logmode and the corresponding modetab if it can t be found in the standard mode tab MODETAB MODTABCO DLOGMOD D4C32782 If you wish to operate TSO in the seven color mode you must make the following entry DLOGMOD SNX32702 3 6 3 IMS In IMS the virtual terminals are defined as Logical Unit Type 2 Example UNITYPE SLUTYPE2 MODEL 2 OPTIONS TRANR NOCD MINAL 011 MINAL 012 3 6 4 In ROSCOE there are no corresponding tables the mode of the communication is taken the BIND parameters Therefore you must make certain that in the definition of the virtual terminals in VTAM you have specified the correct logmode and the corresponding modetab if it can t be found in the standard modetab MODETAB MODTABCO DLOGMOD D4C32782 3 6 5 HCF In HCF there are no corresponding tables the mode of the communication is taken from the BIND para meters Therefore you must make certain that in the definition of the virtual terminals in VTAM you have speci fied the correct logmode a logmode valid for an SNA terminal with a screen size of 1920 characters Example HPS192
79. L IKJ56700A SSCR1 EQU DC C USERID DC X 0101 ENTER DC x 110001 SE SPECIAL REG ON 1 SSCRIE EQU XCSCRMS ELABEL SSCR2E second subentry XCSCRMS ELABEL SSCR2 interlaced subentry SPECIAL REGISTER 1 XCSCRMC POS SMDSSPRE SMDSBLOK X 8000 HEXVAL 0001 XCSCRMC POS X 0234 CHARVAL Password 8 1 80 5 1 564 XCSCRMC POS X 0234 HEXVAL D781A2A2A6969984 SSCR2 EQU DC X 10 SET CURSOR ADRESS DC AL2 8 1 80 20 1 CURSOR ADRESS OF PASSWORD DC C PASSWORT DC X 0101 ENTER DC X 110002 SET SPECIAL REG ON 2 SSCR2E EQU SCRIE EQU End Header 1 6 16 8 Example 2 Loggon inTSO over RACF with the help of passticket XCSCRMH NAME SCREE ELABEL SCR2E Header 2 XCSCRI ELABEL S2CRIE first subentry XCSCRI ELABEL S2CR1 interlaced subentry PARE IF ERSON 56 XCSCRI POS SMD PERS SMDSBLOK X 8000 HEXVAL 00000056 ECIAL REGISTER 0 XCSCRI POS SMDSSPRE SMDSBLOK X 8000 HEXVAL 0000 XCSCRI POS X 0001 CHARVAL IKJ56700A EQU DC x 20001A DC X 0101 DC X 110001 EQU HOB 79 TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and OS 390 XCSCRMS ELABEL S2CR2E second s
80. L1E also ends the output at the start no other macros may follow after the first macro XCJCL1E Lines with XCJCL1E must not be present blocksatz aus XCJCL2E A JCL entry is ended with this macro The macro XCJCL2E must be defined at the end of every JCL entry Examples 1 The data output should result to SYSOUT A At the start of the output i e before the actual data a SYSOUT A START line and at the end i e after the actual data the SYSOUT A END line should be put out 2 5 50 x 001800010001C1 SYSOUT A jINE SYSOUT A BEGINNING jINE SYSOUT A END 2 A HOBCOM program reads data that shall be processed by LKED or another program The needed JCL is stored under the name RDR JCL1 XCJCL2 NAME RDR JCL1 HOB 67 TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and OS 390 JOB 1 MD CLASS A K XCJCL1LA LINE LKED EXEC LKED XCJCLILA LINE LKED SYSLMOD DD DSN XCJCL1LA LINE LKED SYSIN DD XCJCLILE LINE JCLILE LI JCL2E macro XCJCL3 can be used to send print output on disk Please note that we do not offer a program yet that sends the stored print output from disk to printer XCJCLTAB DS OF XCJCL3 NAME name DISP H CLASS F PRI 7 SPFIL3 TSP NAME As name enter a freely choosen maxim
81. M or a com mand in one string OF H 0 7 XCTEGROE XCT LENGTH OF TABLE EGRO LABEL G1LABEL NAME GRUPPEI USSOUT G1USSOUT USSCOM G1USSCOM TIMEOUT 120 MASKP 12 P1COM TSO 2 COVTC PA CICS SA LOGM D4C32792 EGRO LABEL G2LABEL NAME GRUPPE2 USSOUT G2USSOUT USSCOM G2USSCOM 60 5 8 P1COM TSO KX With the of the macro XCTCT terminals are assigned to a group with the help of the macro XCPERS persons are assigned to a group If a person belongs to a group it is possible to suppress certain P keys by parameter of the macro XCTEGRO or it is possible to get with a certain P key imme diately the application without showing the USSCOM or the session will be canceled after a certain if when the connection between host and pc is brocken 50 HOB HOBCOM under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM 6 6 SCREEN LAYOUT XCUSSOUT If you wish an output message similar to a USSTAB can be displayed on the HOBCOM console To do this entries in the VCTCT are necessary Starting at line 7 of the HOBCOM console you can define any screen layout you wish One possibility is to list and explain the command abbreviations entered in the table after the label XCUSSCOM Standard defin
82. M LOADED You entered the command CANCEL although no batch program was started THIS PROGRAM HAS NO CANCEL EXIT The user has attempted to terminate a program which does not have a cancel exit NO COMMAND SPECIFIED You pushed the data release key without entering a command NO COMMAND IN BUFFER No command has been entered in the batch console which can be stored NO STORAGE AVAILABLE The main storage managed by HOBCOM is full Increase the value of the SIZE statement for the partition or class in which HOBCOM is running Refer to the Installation Guide HOB 127 MESSAGES HOBCOM under MVS and OS 390 COMMAND NOT FOUND An invalid command has been entered NO PROGRAM NAME SPECIFIED The user has pressed the ENTER key after the word EXEC without entering a program name SPECIFIED PROGRAM NAME TOO LONG The program name entered is longer than eight characters or no spaces have been left between the program name and the subsequent parameters SPECIFIED PROGRAM NOT FOUND The user has attempted to invoke a program that does not exist PROGRAM IS NOT EXEC UTABLE You wanted to start a program with EXEC that has to be called with LOAD PROGRAM MUST BE CALLED FROM TERMINAL The user has attempted to invoke a program from the batch console this program however can only be invoked from the HOBCOM console of a virtual terminal PARAMETER STRING HAS MORE THAN 64 CHARACTERS The parameter string must not be long
83. M abbreviations can be defined The abbreviations similar to USSTAB facilitate the invocation of HOBCOM functions The commands are entered using the macro XCUSS XCUSS ABB abbreviation COM command abbreviation enter the abbreviation here command the command must always be entered in apostrophes If you wish to use apostrophes in the command you must enter two apostrophes The last command is followed by a byte containing X FF to indicate the end of the table Example XCUSSCOM EQU 55 5 COM EXEC PA TSO PF MOVSP MSG ABCD XCUSS ABB CICS COM EXEC PA CICS1 PF INV DC X FF Command abbreviations can now be used in the ground mask The entire command will be shown when the PF4 key is pushed instead of the Data release key so HOB 5 05 390 TERMINAL CONTROL TABLE FOR HOBCOM 6 8 TABLE WITH PRINTER FORM DEFINITIONS XCPRPAR The printer form definitions are entered after the label XCPRPAR By specifying the appropriate parame ter when invoking the print program NOTE PRVM you may use any print form when printing on a HOBCOM printer The following parameters are currently entered in the table a generally valid printer parameters FORM1 36 lines page and 12 characters inch 96 and 158 characters per line respectively FORM2 36 lines page and 10 characters inch 80 and 132 characters per line
84. M under MVS and OS 390 PRIPROT X B1 SECPROT X 90 COMPROT X 0000 RUSIZES X 8888 PSERVIC X 000000000000000000001100 84 HOB under MVS OS 390 PRINTING WITH HOBCOM 8 PRINTING WITH HOBCOM 8 1 PRINTING FROM CICS ON STANDARD 3270 TERMINAL 8 1 1 DFT terminal Necesseary printer definitions in VTAM UADDR 111 ERM 3277 ISTATUS ACTIVE CICS DFHTCT TYPE ACCME TRMTYPE COMPAT NO ERRATT NO PGESIZE 24 80 PGESTAT AUTOPAGE TCTUAL 255 TIOAL 160 RMSTAT TRANSCE RMIDNT SPRI NETNAME SPO1 RMPRTY 0 PX PX PX PX in the HOBCOM major node Virtual terminals and printers which are to be allowed to print from CICS are to be entered in the major node of HOBCOM CODISOE E APPL SP01P I NOPASS EAS 4 MODETAB MODTABPR VPACING 2 in the HOBCOM TCT ERM HTOE110 FLAG OPT ERM SP01 PRINT 0100 For printing from CICS the programm PR3287 has to be started as batch a task HOB PRINTING WITH HOBCOM under MVS and OS 390 EXEC PR3287 PA CICS SA SP01P PRI SP01 PARAM parameter The definitions above enable the print on a control unit printer If the printer is connected to a DFT terminal the real printer in VTAM has to be defined a
85. MANENT BALR R14 R15 GET STORAGE LR RO1 RH2 NEW LENGTH W O INTRODUCTION MVC 0 2 RSP1 0 RHO DISPLAY FLAG STH RH1 2 RSP1 SET NEW NUMBER LA RH2 4 RHO ADDRESS OF OLD ENTRIES SEE RH3 3 OLD NUMBER TIMES 8 LA R00 4 RSP1 NEW ENTRIES FROM HERE ON MVCL R00 RH2 TRANSFER APPLS ST RSP1 SASUPNAT SET INTERIM STORAGE LR RSP1 RHO GET OLD STORAGE 5 R15 ROUTINE FREE STORAGE BALR 814 815 FREE STORAGE B PEXROK JUMP BACK DS OH REMOVE ICM RHO 15 SASUPNAT GET ADDRESS FROM INTERIM STORAG BZ PEXROK FOUND LA 2 4 FROM HERE ENTRIES LH RH3 2 RH0 NUMBER OF ENTRIES DS ENTRY CLC 0 8 RH2 8 RPARA THIS APPLID 157 APPENDIX HOBCOM under MVS and OS 390 BE PEXO04 YES LA RH2 8 RH2 NEXT ENTRY BCT RH3 PEXO02 CONTINUE CHECKING B PEXROK READY PEXO04 DS ENTRY FOUND MVI 0 RH2 0 ERASE ENTRY PEXROK DS OH JUMP BACK LM R14 R12 12 R13 GET REGISTER XR R15 R15 DELETE RETURN CODE BR R14 JUMP BACK PEXRERR DS OH JUMP BACK ERROR L R14 12 R13 GET RETURN JUMP REGISTERS LM ROO R12 12 8 R13 REGISTER BR R14 JUMP BACK DROP RPROG PROGRAM
86. N HOBCOM MACLIB LABEL 2 SL DISP SHR UNIT 3400 9 VOL SER HOBCOM APE3 DD DSN HOBCOM LIB1 LABEL 3 SL DISP SHR UNIT 3400 9 VOL SER HOBCOM 1 DSN HOBCOM LINKLIB DISP SHR TARG2 DD DSN HOBCOM MACLIB DISP SHR TARG3 DD DSN HOBCOM LIB1 DISP SHR SYSIN COPY INDD El OUTDD TARG1 COPY INDD E2 OUTDD TARG2 COPY INDD E3 OUTDD TARG3 I ol ol oll ll When using UCC1 please give the label LABEL EXPDT 98000 For performance reasons it may be advantageous to copy the HOBCOM modules into an authori zed library and to define HOBCOM as non swapable HOBCOM ENTRY in SYS1 PARMLIB SCHEDxx Our tape was invoked with the help of the following job steps STEP4 EXEC PGM IEBCOPY SYSPRINT DD SYSOUT IN1 DD DSN HOBCOM LINKLIB DISP SHR DD DSN HOBCOM TEMPLIB VOL SER MVSDL2 UNIT 3380 DISP NEW CATLG SPACE CYL 1 1 3 DCB RECFM U BLKSIZE 23200 SYSIN DD COPY 00 1 14 HOBCOM under MVS OS 390 INSTALLATION GUIDE SELECT MEMBER XCHOBCOM XCHOBCST
87. NERAL REMARKS 1 1 OVERVIEW With HOBCOM you have a HOST Software available that gives you a variety of advantages with one module It can be used in processors with 370 or 390 architecture that means in 9370 4381 3090 9672 and ES 9000 processors and is supported by MVS XA and MVS ESA HOBCOM runs under MVS as VTAM application it needs ACF VTAM and occupies one region It can communicate with all 3270 monitors and 3270 printers HOBCOM reaches its full performance volume with HOB E terminals or PCs running HOBLink 3270 For communication with different terminal types two different protocols are used the basis protocol with 3270 data flow that can be transmitted NON SNA as well as SNA and the X protocol that presumes SNA Under MVS both protocols are supported the activation results through a corresponding logmode For the Communication with several terminal types four different protocols can be used Protocol SNA NON SNA Mode Communication with basics protocol 3270 data stream CUT HOB S Terminal IBM 3270 Terminal HOBLink 3270 S Protocol SNA or NON SNA or HOBLink J Term 3270 emulations of other manu DFT factuers TN3270E terminal sessions 3270 printer TN3270E printer session E Protocol SNA or NON SNA CUT Terminals X Protocol SNA DFT HOB DFT Terminals Y Protocol SNA DFT HOBLink 3270 HOBLink J Term These protocols you can activate by the corresponding logmode A further advant
88. NO ADDR DROP RSYS SYSTEM ADDRESSES NO ADR LTORG PEXEA EQU ALREADY IN USE DC AL1 L PEXEAT LENGTH PEXEA Dc C SAPPL AREADY IN USE EQU FULL ALL USED DC AL1 L PEXEFT LENGTH PEXEE DC C ALL SAPPLS IN USE PEXPOOL1 DS OF DC 18 909 DC CL8 Cc910 DC 8 911 DC CL8 C912 PEXPOOL2 EQU gt PEXEND DS OF END EXIT ROUTINE 158 HOB under MVS and OS 390 A APPENDIX A 5 ERROR MESSAGES WHEN USING LAPTOPS All of the following messages are diplayed on the PC VTAM Messages from the USSTAB 1 2 3 WRONG FORMAT UNKNOWN COMMAND UNKNOWN PARAMETER PARAMETER xxx INVALID in place of xxx the erroneous parameter is displayed FUNCTION NOT SUPPORTED SEQUENCE ERROR BIND REJECT FROM APL NOT ENOUGH VTAM MAIN STORAGE OPERAND MISSING VTAM ECHO Other Messages 15 19 17 21 22 23 24 25 Pseudo LU not found in TCT no more logical channels available invalid password in the HOBCOM TCT LU not defined erroneous LU LTKEY erroneous PU TYPE erroneous LU already in use HOB 159 APPENDIX 5 05 390 6 HOBCOM OPERATOR COMMANDS CO ACT DIR NAME ALIAS LABEL CO BAT OFF CO BAT OFF ALL CO BAT OFF TERMINAL CO BAT ON CO BAT ON ALL CO BAT ON ALL IGNOFF CO BAT ON TERMINAL CO CANCEL TASK CO CLOSE DISK CO DEFINE DCACHE1 CO DISCTASK TASK CO DISPLAY DIRECTORY
89. OM usually reserves sufficient storage space Should this message appear inform the HOB Software Service and allocate more storage space 00006 SHORT ON STORAGE The virtual storage managed by HOBCOM is insufficent 00007 PHASE xxxxxxxx NOT LOADED GETVIS RC The XCTCT phase xxxxxxxx could not be loaded The GETVIS of this partition is probably too small XCM00008 DUMP HOBCOM has created a dump Please contact your system manager or the HOB Software Support XCM00009 END PROG HOBCOM The program HOBCOM has been ended 00011 STOP ROUTINE ENTERED This message appears in MVS when STOP xxx is entered xxx is the name of HOBCOM job XCMO00012 USER TASK STILL ACTIVE If HOBCOM could not be terminated because users are still active this message appears in MVS after the message 00011 has been displayed Terminal Control Task Messages XCTM0001 ID xxxxxxxx LOGON Terminal xxxxxxxx has logged on to HOBCOM 120 HOBCOM under 5 OS 390 MESSAGES XCTEOO002 ID xxxxxxxx POWER ON The power ON code of a non SNA terminal has been received XCTEOO003 ID xxxxxxxx POWER ON The power ON code of an SNA terminal has been received XCT00004 ID xxxxxxxx POWER OFF The power OFF code of an SNA terminal has been received XCT00005 ID xxxxxxxx LUSTAT The logical unit status of an SNA terminal has been received The meaning of the codes can be found in the IBM publicat
90. PL xxxxxxxx xxH During the OPEN of the VTAM ACB an error message was passed to PR3287 Consult the VTAM Manual Chapter Description of the VTAM Macros Instructions to find the cause of the error or inform the HOB Customer Service ERROR 010015 PAPPL xxxxxxxx NOT DEFINED The primary application entered e g CICS IMS TSO has not been defined ERROR PR010016 PAPPL xxxxxxxx NOT ACTIVE The requested primary application application program e g CICS TSO IMS is not active and as a result cannot be reached ERROR 010017 LOGMODE NOT DEFINED The LOGMODE entered is not listed in your MODETAB Ask the system programmer for a valid LOGMODE ERROR PHR010018 REQSESS RTN xxH FTN xxH SENSE Request Session was rejected The meaning of the codes can be found in the VTAM Manual VTAM programing appendix B ERROR PR010019 PAPPL xxxxxxxx LOGON REJECTED RC xx SENSEZXXXXxxxx The Logon on the Primary Application was rejected You will find the meaning of the code in the VTAM Manual VTAM programing appendix B ERROR 010020 PAPPL INVALID BIND PARAM The primary application CICS or DSPRINT has sent the wrong BIND parameters for LOGON This may be due to an incorrect LOGMODE LOGON with LOGMODE ERROR 010021 NO BIND OUT OF SERVICE The selected application does not send a Bind no connection is established This may be be cause the virtual terminal SAPPL has been set OU
91. Printer is busy 01010101 unknown Printer either entry in JCL Table missing or wrong print command 01050001 The terminal has been switched off while printing Turn the terminal on and enter GO in the COBA 01050002 The printer has been turned off while printing Turn the printer on and enter GO in the COBA 01050003 Wrong Load parameters The print parameters entered in the TCT are incorrect 01050004 Attribute record duplicate Restart the print operation If this message appears again notify HOB Software Support 01050005 After the attribute record no normal record Restart the print operation If this message is displayed again notify HOB Software Support 00000011 is using the printer Wait a while and then reenter the print command ERROR 010010 NO PAPPL xxxxxxxx IN COMMAND The parameter string was entered incorrectly when invoking program PR3287 ERROR 010011 NO SAPPL xxxxxxxx IN COMMAND The parameter string was entered incorrectly when invoking program PR3287 A SAPPL entry must be made because a table of SAPPL entries was not generated by HOBCOM ERROR PR010012 SAPPL xxxxxxxx NOT DEFINED The virtual terminal name entered has not been defined 134 HOB HOBCOM under 5 05 390 MESSAGES ERROR PR010013 SAPPL xxxxxxxx ALREADY ACTIVE The virtual printer VTAM node entered under SAPPL is already in use Re invoke PR3287 and enter a different SAPPL ERROR PR010014 SAP
92. R 010003 EITHER OUTFILE OR 5 You may use only one of the two parameters for invoking ERROR 010004 INVALID OUTFILE FILE NAME The name entered at the parameter OUTFILE is wrong Compare the build up of the parameter in chapter Parameter at invoking ERROR 010005 PRINTER PARAMETER NAME INVALID The parameter entered for the printer form is incorrect ERROR 010006 SESSION ACTIVE LOGON NOT POSSIBLE A LOGON to a VTAM application has already been executed ERROR PR010007 NO SESSION ACTIVE NO LOGOFF The session with the VTAM application was not activated or has already been ended ERROR PR010008 WRONG TEXT AFTER COMMAND Text has been entered following the command LOGOFF SHUTDOWN GO or HALT These commands must be entered without subsequent text ERROR PR010009 P E HOBCOM has received an error message from the printer hardware error Consult the following list for the meaning of the error messages 01010001 Terminal non existent A print task must be started for this terminal Use EXEC COBA 01010002 no printer generated There is no driver entered in the TCT for this printer HOB 133 MESSAGES HOBCOM under MVS and OS 390 01010003 Terminal is turned off Turn the terminal on and enter GO in the COBA 01010004 Printer is turned off Turn the printer on and enter GO in the COBA 01010005 Driver program not available The selected driver has not been entered in the TCT 01010006
93. RINTING A LOCAL HARDCOPY ON E TERMINAL 85 000022 90 8 7 PRINTING FROM HOBCOM OVER 91 HOBCOM AND TCP IP 92 9 1 HOBCOM DEFINITIONS FOR THE TCP IP 92 HOB 9 2 TN3270 CONNECTIONS TO 9 3 TN3270E CONNECTIONS 9 4 aia 9 5 Printirig Or ING te EE NU eb 9 6 PRINTING ON A USER 9 7 PRINTING OVER SMB inre cep ee P EE Che Le xp Panne 10 HOBCOM DRIVER ROUTINES 10 1 Hielo 10 2 PUN etae e de pad eaten vci tei iata e M RU PRINT 2a 10 4 2 SCREEN eU 10 6 lt Mn ee nr 10 74 VSAM zu on ED OE EE Det rte ab rt RE 10 8 SPDS 4 iet cote ong Eo 11 MESSAGES 14 1 GENERAL REMARKS di i eese ite cites eser regen 11 2 HOBCOM CONSOLE MESSAGES ON THE HOBCOM 2 2 11 3 HOBCOM CONSOLE MESSAGES UNDER MVS XCM 114 MESSAGES iiis dott ted ice est det eie e t dar d E dade REP nant ska ue 11 5 COVIG COVTOP MESSAGES eoe eee eee nt
94. S 390 3 7 1 2 Definition in DSPRINT In DSPRINT you define the HOB printers as IBM 3287 printers You can address them as LUTYPE1 or LUTYPE3 Example of a definition 2 Il L L E QABP3LQA L E QABP3BFS L E QABP3WID L E QABP3PLN L E QABP3TMG L E QABP 3BMG L L E QABP3TYP L LOC 57 PIC LOC 65 PIC LOC 69 PIC LOC 73 PIC LOC 75 PIC LOC 76 PIC LOC 77 PIC LOC 78 PIC LOC 79 PIC LOC 80 PIC 8 NO1P E 1 B 0 E 1 B 0 E 3 B 768 E 3 B 132 E 2 B 72 B 2 B 2 B 132 1 2 Il 00 2 ll 2 ll 2 2 ll 2 2 2 nn un Be E 1 E 1 E 3 E 1 2 3 7 1 3 Definition in IMS In IMS you define the HOB printers as 3287 printers You can address them as LUTYPE1 or LUTY PES 3 7 2 Definition for the 3770 Emulation Using program PR3770 you can print directly from your spooling system on a HOBCOM printer HOB COM printers emulate RJE stations and must be defined accordingly 3 7 2 1 Definition in JES2 To print directly from JES2 you must specify your printer in the JES2 definitions
95. SCMD USSPAR SSCMD SSPAR QU SSMSG SSMSG SSMSG SSMSG SSMSG SSMSG SSMSG SSMSG SSMSG SSMSG SSEND DC DC DC DC DC DC EQ DC DC DC DC EQ DC DC DC DC DC DC DC EQ 170 N M M M M OGEN CMD IBMTEST FORMAT BAL PARM P1 D PARM P2 D EFAULT 10 EFAULT 01 CMD LTC1 R PARM APPL 123456789ABCD LOGON FORMAT PL1 DEFAUL CMD LTC2 R PARM APP CODISC1 LOGON FORMAT PL1 ID DEFAUL MSG1 BUFFE 5501 5502 MSG2 BUFFE MSG3 BUFFE 5503 MSG4 BUFFE 5504 5505 MSG5 BUFFE MSG6 BUFFE 5506 MSG7 BUFFE ESSO M M M M M M M M 5508 MSG8 BUFFE MSG12 BUFF 550 MSG13 BUFF ESSOD CODISC2 WRONG FORMAT UNKNOWN COMMAND PARAME R UNKNOWN INVALID FUNKTION NOT SUPPORT ORDER MISTAKE BIND REJECT FROM APL VTAM HAS NOT ENOUGH OPERAND MISSING VTAM ECHO
96. Start HOBCOM HOBCOM can be started using the following JOB GOHOBCOM JOB JOBLIB DD DSN HOBCOM LOADLIB DISP SHR LOAD EXEC PGM XCHOBCOM SYSPRINT DD SYSUDUMP DD CODIDUMP DD PARAM DD PHASI If necessary the parameter UNIT should be specified for the JOBLIB assignment E XCTCT GOHOBCOM CLASS A REGION 512K TIM SYSOUT SYSOUT A SYSOUT The XCTCT see chapter 5 is read via the assigned to the label PARAM If XCTCT is to be loaded you can make the following entry PARAM DD DUMMY If HOBCOM is to be started from a procedure then DD is not allowed Instead a file with content must be created PHASE XCTCT The name of the file must then be entered in the Start Job in place of the DD 148 HOB HOBCOM under MVS OS 390 A APPENDIX A 2 Sample for Terminal Groups When the XCTERMA table is created the assignment of terminals to groups is determined In our example N B this does not correspond to the TCT we delivered there are three terminals NO1 2 and Terminal 01 does not belong to a terminal group That means sends the standard XCUS SOUT mask to the terminal with this address 02 belongs to Group 1 08 to Group 3 The mask for all group 1 terminals is defined under the label G1USSOUT and the mask for the terminals in group 2 is defined under the label G2USSOUT The commands
97. T DEFAULT PL1 10 0123456789ABCD ON 1 ID DEFA ULT CODIS OGMODE DEF AULT CODLOG M CODX2 REP LOG ON FORMAT P ID DEFA ULT CODIS2 OGMODE DEF AULT CODLOG10 CICS 52 REP LOGO FORMAT PL1 ID DEFA ULT TESTCICS ON FORMAT PL1 ULT APCICS2 MSG 1 MSG 2 MSG 3 MSG 4 MSG 5 MSG 6 MSG 7 MSG 8 MSG 10 B EX SSSSSSSS WRONG FORMAT COMMAND UNKNOWN PARAMETE UNKNOWN PARAMETE INVALID FUNCTION NOT SUPPORTI ORDER MISTAKE BIND REJECTED VTAM MEMORY NARROW T ee AL2 PTEXTE PTEXTA C VTAM 157 55 IF NO SESSION 2 LENGTH COM FEED Please note you must change the ACB name in the above example CODIS and CODIS2 for a second if you are going to use another name in the XCTCT HOB 169 APPENDIX HOBCOM under MVS and OS 390 TITLE USSTABLT HOBCOM USSTAB FOR LAPTOPS HOBCOM ASY PRINT USSTABLT USSTAB IBMTEST USSCMD USSPAR USSPAR US
98. T OF SERVICE ERROR PR010022 PAPPL xxxxxxxx NO SDT NON SNA INSTALLATION The selected application does not send an SDT command SDT start data traffic although BIND registers that the connection has already been established This may be because the vi r tual terminal SAPPL has been incorrectly installed in the application program e g CICS for instance as a NON SNA terminal ERROR 010023 PAPPL xxxxxxxx NO UNBIND TIME LIMIT The session with the selected VTAM application has been terminated but the VTAM application has not sent an UNBIND for this reason the session is terminated by PR3287 This may be be cause the VTAM application was terminated abnormally HOB 135 MESSAGES HOBCOM under MVS and OS 390 ERROR PR010024 PAPPL xxxxxxxx REQ xxH RTN xxH FTN xxH An error has been reported to program PR3287 The request code for the current access is xx Refer to the VTAM Manual VTAM Messages Chapter Return Code Sense Fields and Return Code Posting Return Code Combination to find the cause of the error or inform the HOB Cu stomer Service ERROR PR010025 SAPPL xxxxxxxx CLOSE ERROR xxH An error was reported to program PR3287 while closing the VTAM ACB Consult the VTAM Maunal VTAM Messages Chapter Return Code Sense Fields and Return Code Posting Re turn Code Combination to find the cause of the error or inform the HOB Customer Service ERROR 010026 R15 xxH The VTAM access xxxxxxxx e
99. The link has been severed 553 An ADVERTISE error has occurred x 554 An SRMOUNT error has occured x 555 A communication error has occurred on a Send call 556 A protocol error has occurred x 557 A multihop address link was attempted 558 A cross mount point was detected This is not an error x 559 The remote address has changed x 55A The connection was closed by a peer HOBCOM internal errors 565 TCPIP eintrag in TCT nicht vorhanden x 566 Header ID in DNS response fehlerhaft x 567 DNS response ist nicht response x 56E DNS response Fehler Nr x 57F keine ANSWER SECTIONS in DNS response 580 2 NamensTeil falsch nur 1234567890ABCDEF erlaubt oder nicht im TCT gefunden x 581 Kein Printer Name oder fehlerhaft 582 Treiber f r in TCT eingegebenen Drucker kann nicht ge ffnet werden x 583 Printer am angegebenen Host nicht definiert x 584 recl 0 x 585 reca 0 x 586 RSP auf RECEIVE DATA FILE empfangen m HOB HOBCOM under 5 OS 390 MESSAGES 587 RSP auf DATA FILE empfangen 588 RSP auf RECEIVE CONTROL FILE empfangen x 589 RSP auf CONTROL FILE empfangen x 58A Treiber f r in TCT eingetragenen Drucker nicht vorhanden x 58B printer name zu lang max 80 x 590 IUCV Send f r SETSOCKOPT completed mit IPAUDIT 0 x 591 IUCV Send f r BIND fehlerhaft x 592 IUCV Send f r BIND completed mit IPAUDIT 0 x 593 IUCV Send f r LISTEN fehlerhaft x 594 IUCV S
100. The user don t have to identify and authorize by logon This is the default value S and X Sessions can be allocated to a group over a personal entry This assignment happens personal not related to the ressource 19 terminalname When person logs on a LU e g a terminal with S or X Protocol or a HOBLink 3270 J Term with Y Protocol that belongs to a group so the LU is allocated to this group When this person logs off and afterwards an other person without membership of a group logs on at the same LU so the second person is allocated to the same group the first person belongs to Exceptions 1 S terminals respectvely emulations that communcate with HOBCOM through S Protocol In this case the second person belongs to the default group XCUSSOUT XCUSSCOM 2 Belongs the second person independent of the protocol to a group so the person gets the own group More information about the assignment of persons LU s to groups you ll find in the paragraph group HOB 5 TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and OS 390 6 12 JCL ENTRIES XCJCLTAB Data can be designated Job Cards in this table that will be worked over later They are used by different driver routines From the XCJCLTAB label on three macros can be used that determine the name of the JCL and even tual necessary additional information XCJCL1 XCJCL2 and XCJCL3 Using the macro 1 first the name of the JCL
101. UPNAM 68 XCUSSBTA 58 XCUSSCOM sol KCUSSOUT eite cd ted oie deed 50 XTETGEN 5 82 32 3222 ER BERN EN 100 Y XsPROTOGOL erani eee estere ne 79 175 INDEX HOBCOM under MVS and OS 390 176
102. VS and OS 390 2 4 STARTING HOBCOM Before you can start HOBCOM your XCTCT must be adjusted chapter 5 Please note that all E terminals and standard 3270 printers as well as the ACB name and the valid HOBCOM password must be entered To start HOBCOM you need a job Example GOHOBCOM JOB GOHOBCOM CLASS A REGION 512K TIME 1440 JOBLIB DSN HOBCOM LINKLIB DISP SHR LOAD EXEC PGM XCHOBCOM SYSPRINT DD SYSOUT SYSUDUMP DD SYSOUT HOBCDUMP DD SYSOUT 5 A7 At the JOBLIB instruction give the parameter UNIT if necessary The XCTCT is reda via the file that is appointed to the PARAM label compare chapter 3 If no XCTCT is to be loaded you may enter PARAM DD DUMMY If HOBCOM ist to be started in a procedure DD is not valid Please create a file with the following contents PHASE XCTCT Enter the name of this file in the startjob replacing DD ie HOB 5 05 390 INSTALLATION GUIDE 17 DEFINING TERMINALS AND PRINTERS HOBCOM under MVS and OS 390 3 DEFINING TERMINALS AND PRINTERS 3 1 STANDARD 3270 TERMINALS AND PRINTERS 3 1 1 Defining a 3270 Terminal HOBCOM assumes principally that a terminal that wants to logon is HOB E Terminal When a standard IBM Terminal should logon or when a E Terminal should be used as a standard IBM Terminal HOBCOM must be in
103. VTAM Messages in particular the chapter Return Codes Sense Fields and Return Code Po sting Return Code Combination 056 ID xxxxxxxx WRONG SNA COMMAND RECEIVED Terminal xxxxxxxx has received invalid commands from the controller XCTE0057 ID xxxxxxxx SEND ERROR POWER OFF HOBCOM has received the response that the send line is switched off The terminal was not switched off correctly via LOGOFF XCTE0058 ID xxxxxxxx WRONG CID RECEIVED HOBCOM has determined while checking the CID SESSION ID that it is incorrect Either the terminal control unit or VTAM has sent an incorrect CID XCTM0059 RECEIVE ERROR R115 xx RTNCD xx FDBK2 xx WAIT While processing a receive command VTAM indicates an error e g VTAM has no more storage space available HOBCOM waits 16 seconds and then prepares another receive command 00060 ID xxH LOGON ERR TERMINAL ALREADY EXISTS You have tried to log on a terminal whose name already exists in HOBCOM 00061 LU ERR R RTNCD xxH FDBK2 xxH VTAM registers an error Consult the IBM manual VTAM Messages in particular the chapter on Return Codes Sense Fields and Return Code Posting 0091 ID xxxxxxxx LOGON GETMAIN GETVIS ERROR Terminal xxxxxxxx has logged on to HOBCOM but due to insufficent storage the logon cannot be carried out XCTM0092 ID xxxxxxxx LOSTERM GETMAIN GETVIS ERROR Terminal xxxxxxxx is to be logged off from HOBCOM but there is no storage space free
104. VTAM to CICS The VTAM BIND informations are alone not sufficient to generate a TCT entry CICS finds most of the necessary information in the TERMINAL table When you use RDO CICS is given the necessary information with the help of the DEFINE command HOBCOM under MVS OS 390 DEFINING TERMINALS AND PRINTERS Example TYPETAB1 GROUP TERMG AUTOINSTMODEL NO AUTOINSTNAME TERMINAL IDENTIFIERS TYPETERM 1 SNANO21 ASSOCIATED PRINTE PIPELINE PROPER ERATOR DEFAUL ERMINAL USAGE ESSION SECURITY If AUTOCONN YES has been given the terminal 1099 automatically on at a CICS EMERGENCY RE START without having to rerun the autoinstall procedure The already given definitions remain as long as at least one session exists When there is no active session the TCT entry is errased TCT entries that have been made with the help of AUTOINSTALL will also be erased at a CICS warmstart and at a coldstart Please note When using your own autoinstall entries you must make sure that the correct LOGMODE entries are available in VTAM i e the correct MODETAB must be given CICS checks if the bind parameter and the TYPETERM parameter correspond when LOGON is reque sted If they greatly differ i e LUTYP3 instead of LYTYP2 the request will be denied That means that CICS first compares th
105. ached to the transmission line which is to be used for the HOB E terminal O The A s must be entered as capital letters This lets you determine if the installation has been suc cessfully completed If the installation has been successfully carried out the following five line string HOBCOM is dis played SYSTEM S lt 5 lt 5 lt 5 lt 58 80 1 amp 2 amp P3 amp 4 amp lt lt lt lt lt LINE N01 5 lt 58 amp 00 00 00 00 1 amp _ 1 Zac 3 4 5 6 4 You can now connect the terminal 4 2 CONNECTING THE HOB E TERMINAL The sockets for connecting power system keyboard and printer are located on the rear panel of the terminal Attach the power cord the COAX cable and the keyboard cable in the corresponding sockets on the back of the terminal A diagram is included in the operating instructions Press the green button located on the front of the terminal if need be switch on the power switch on the rear of the terminal If HOBCOM and the terminal have been installed correctly the HOBCOM console panel will appear on the screen 4 3 CONNECTING TO A 3174 CONTROL UNIT The file transfer aid bit must be set in the 3174 control unit if a HOB E terminal is connected to it query 125 6th bit 5 05 390 CONNECTING THE TERMINALS
106. acro Library contains the macros for die HOBCOM table Source Library contains the table XCTCT MODETABs and USSTABs Meaning of these files XCTCT System Table for HOBCOM in which user specific entries are kept compare chapter 5 Modetab for NCCF MODTABOX Modetab for X terminals MODTABLT Modetab for laptops USSTABN1 USSTAB for NON SNA terminals with imme diate shut off USSTAB for NON SNA terminals with delayed shut off USSTAB for SNA terminals with immediate shut off USSTAB for SNA terminals with delayed shut off USSTAB for SNA terminals under VTAM version 1 with delayed shut off USSTABX USSTAB for X terminals USSTABLT USSTAB for laptops sample jobs 13 INSTALLATION GUIDE HOBCOM under MVS and OS 390 2 2 2 Loading the HOBCOM Programm Phase In the first step the three data sets have to be allocated The following amount of space is sufficient HOBCOM LINKLIB SPACE CYL 2 1 3 DCB RECFM U BLKSIZE 23200 HOBCOM MACLIB SPACE CYL 1 1 10 DCB RECFM FB BLKSIZE 6160 LRECL 80 HOBCOM LIB1 SPACE CYL 1 1 10 DCB RECFM FB BLKSIZE 6160 LRECL 80 Then the program phase is loaded together with the libraries Example Job TAPINHC JOB ACCT HOBCOM LESEN MSGLEVEL 1 1 MSGCLASS X LOADS HOBCOM FROM THE 5 INTO THE LIBRARIES COPY EXEC PGM IEBCOPY SYSPRINT DD SYSOUT 1 DSN HOBCOM LOADLIB LABEL 1 SL DISP SH UNIT 3400 9 VOL SER HOBCOM APE2 DD DS
107. acter Example X A1DB65CB626A9052B5D0B0C0B3 DB is exchanged with 65 CB with 62 6A with 90 etc These values refer to the EBCDIC character set they are interpreted by the driver once more and are changed into an ASCII character for the printer If you want to use this option please contact the HOB Software Support and ask for the translation tables This control sign enables the addressing of a form parameter from the TCT If for ex ample the print use invokes the formparameter DRTEST a print line with the contents must be sent Hex feature must be set for this 4 Translation table EBCDIC into ASCII follows pairs of 2 Bytes that determine the cha racter to be translated and the character in which will be translated EBCDIC into ASCII characters A4 C1 41 C2 42 The character A will be translated into hexa 41 and the character B into hexa 42 The text ABCD becomes the text hexa 4142 CD output long line it is possible that more than one dataset mixed with X 90 follows which will be output without attribut interpretation or carriage return The characters will be interpreted as EBCDIC X EO acoustic alert at the printer the next byte determines the number of alert signals at the printer 1 to 255 length of the alert signal This control sign enables the following in connection with second Byte compari son of the printer name out o
108. age 0111 An OPEN ERROR is indicated while opening the VTAM ACB of the terminal control task normally IDZCODIS The error code indicates that the VTAM node is already being used by another job Check whether HOBCOM is already active in another partition or another task For further information consult the VTAM Programming Manu al in particular the chapter entitled Description of the VTAM Macro Instructions XCTM01 12 CLOSE ERROR xxH An error is indicated while closing the VTAM ACB of the terminal control task The error code is displayed in hexadecimal form xxH hexadecimal Refer to the VTAM Programming Manual in particular the chapter covering the Description of VTAM Macro Instructions 00 ID xxxxxxxx LAPTOP START LU xxxxxxxx The connection between a with HOBCOM asynchron and HOBCOM was built As ID Name the VTAM Name of the PC was used LU is the HOBCOM intern name of the PC This name was saved in the PSETUP on the PC under PSEUDO LU NAME XCTEOS301 ID xxxxxxxx LAPTOP LU OCCUPIED xxxxxxxx Another PC with the same PSEUDO LU NAME is already logged in XCTEOS302 ID xxxxxxxx LAPTOP LU MISSING xxxxxxxx The name which is registered as PSEUDO LU NAME in the PSETUP on the PC could not be found in the HOBCOM TCT Please register this terminal with the makro XCTLTS HOB 125 MESSAGES HOBCOM under MVS and OS 390 XCTE0303 ID xxxxxxxx LAPTOP LU NOT LT xxxxxxxx The name which is registered
109. age of HOBCOM is the comfortable printing control You have the possibility to send all printing from all applications to a printer that can be connected to any terminal This pertains especially to the 3287 print i e from CICS or RSCS 3770 print and print out of the VM spool HOBCOM gives you a comfortable printing control for this purpose that allows i e changes in the form parameter online and to grip into running batch print uses at any time Besides printer drivers are integrated into HOBCOM that fit to a large number of printers that are on the common market Coax Printers that normally work only as 3287 printers can also be used for 3770 print with HOBCOM When printers is connected to a HOB E terminal many different print drivers are available Contrary to this only standard 3287 functions are supported at printing over standard terminals or coax printers Special functions such as passing on of HOBCOM or printer specific control signs can be performed through the so called Hex Feature The sign is used to pass on escape sequences to the printer Form parameters can be established in the HOBCOM TCT that e g control the number of lines per page the number of characters per inch the type face etc These parameters can be set by all print programs with PARAM and can be changed during printing with SET PARAM HOBCOM offers you data transmissi on compression and selection in communication with the real terminal or with 3270 machi
110. al 8 digit string we suggest SPOOL DISP The disposition is not evaluated at the moment This entry becomes meaningful when a program is available that sends a file from disk to the printer CLASS The class is not evaluated at the moment This entry becomes meaningful when a pro gram is available that sends a file from disk to the printer PRI The printer is not evaluated at the moment This entry becomes meaningful when a pro gram is available that sends a file from disk to the printer SPFIL1 name of the cabinet in which the file is stored SPFIL3 specifies the name under which the file will be stored in the archives in the above ex ample TSP plus a sequential number To end the JCL table the last two bytes must contain zeros DC AL2 0 under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM 6 13 PASSWORD FOR LAPTOPS LTKEY If you wish to prevent that unauthorized machines make contact with your Host while using a laptop you can enter maximally 8 digit password after LTKEY If you wish to relinquish the password protection enter zero The password must be entered into the PADSETUP of the Laptop in the HOST PASSWORD field XCTCTANF XTCTGEN ACBNAM HOBCOM TERMA XCTERMA PRTAB XCPRTAB USSOUT XCUSSOUT USSCOM XCUSSCOM PRPAR XCPRPAR USSBTA XCUSSBTA PERSTA XCPERSTA DIANAM XCDIANAM COMASK XCCOMASK LTKEY ABCD5678 PASSW XCPASSW
111. al line feeds when it encounters a page feed The default value is 0 PP Print Position is the number of blanks inserted before each line is printed The default value is 0 VMI vertical motion index Indicates the length of a line feed in multiples of 1 48th of an inch The parameter is specified as a binary value in one byte 0 to 255 SPA Spacing width of a printed character The number of characters which are to be printed in one inch are specified in one byte The default value is 12 LEN maximum length of a printed line The number of characters which are to be prin ted in one line is specified in one byte as a binary number Characters above this are truncated Special case LEN O this indicates that the maximum length is not tested A list of some of the feed bytes 00 bis 7F data record number of line feeds 80 81 83 8D 8E 8F 58 data record with line feed attribute data with variable feed extra feed advance to end of page print buffer HOBCOM under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM 90 printer character without translation accoustic alarm FE change parameter FF reset parameter Examples 1 A form with 80 characters per line 36 lines per page and a line at the end of the form E FORM2 LABEND PPFORM2E LPP 36 SPACING 10 AL1 81 Length of nearest print record x 06 Feed 8gct Separation line AL1 2 Length o
112. ample XCTCPIP NSERVER 123 45 123 1 VMTCPIP TCPIP DOMAIN HOB DE HOST HOST9221 TIMEOUT 15 9 1 3 PASSWORD FOR S AND Y SESSIOS IN THE HOBCOM TCT In order to build a TN3270E TN3270 session to HOBCOM an authorization for S sessions or Y sessions is required This authorization is granted by the HOBCOM password an additional feature entailed with Separate costs In the HOBCOM TCT you have to enter a password which contains information about the number of Y or S sessions that are to communicate with HOBCOM This password you can obtain from the HOB support S sessions are used for emulations with TN3270 display session or emulations with TN3270E screen or printer session HOBLink 3270 without HOBCOM support uses TN3270E and needs one S sessions per connection HOBLink J Term with TN3270E uses up one S session too Y sessions are required for HOBLink 3270 with HOBCOM support and for HOBLink J Term with connection 9 2 TN3270 CONNECTIONS TO HOBCOM 9 2 1 TN3270 Display Session to HOBCOM S Session If the clients are connected over TN3270 only display sessions are possible no printer sessions Sample configuration in HOBLink 3270 HOB 5 05 390 HOBCOM AND Configure Connections WOHNGUTEN TH BITES 05 HOBCOM AND HOBCOM under MVS and OS 390 9 3 TN3270E
113. arget environment Host PC As Name the printera lias or the printername from the macro Macro XCPRT can be entered the HOBCOM alias name of the target host Instead of HOST and PRI the OUTFILE parameter can be used EC PR3287 OU EC PR3287 OU Snamel printerrname AGO VVwwxxyy printername AGO NET HOBCOM driver program for printing on LPD name1 HOBCOM name of the target host This second part of the name has to be entered toge ther with the TCP IP address in the XCTCT under the XCHOST macro The TCP IP address is token from the macro printername VVWWXXyy the third part of the name is the name of the printer on the target host Instead of a name which is entered in the VCTCT the target address in OUTFILE can be entered as four hex values These 4 bytes are the TCP IP target address Example Address 195 46 235 68 Hex 2 44 That s the way you enter the target host in the NOTE program too as default value when NOTE is called with the OUTFILE parameter Example E OUTFILE ET namel printeralias appears HOB ENTER NUMBER OF PICTURE Px 1 OUTFILE SNET C32EEB44 printername 103 HOBCOM AND HOBCOM under MVS and OS 390 Printing on LPD over driver In order to print on LPD out of HOBCOM the XCPRT macro can be used optionally T
114. arts at the label XCTCTANF and the macro XTCTGEN Structure of the XTCTGEN macro XCTCTANF XTCTGEN ACBNAM name ERMA XCTERMA PRTAB XCPRTAB EGRO XCTEGRO USSOUT XCUSSOUT USSCOM XCUSSCOM PRPAR XCPRPAR USSBTA XCUSSBTA PERSTA XCPERSTA JCLTAB XCJCLTAB IKEY passwort UPNAM XCUPNAM COMASK XCCOMASK PASSW XCPASSW xx MK KM KX This macro addresses the individual tables If one or more of the tables is not to be used omit the corre sponding entry The meanings of the parameters are listed below PRTAB USSOUT USSCOM PRPAR USSBTA APPLTA PERSTA JCLTAB LTKEY COMASK PASSW 42 ACB Name for HOBCOM 1 address of the terminal table 2 address of the terminalgroup table address of the printer table 3 address of the console mask 4 address of the console commands 5 address of the printer parameters 6 address of the batch task commands 7 address of the applications table address of the user entries 10 address of the JCL table 11 address of tht laptop password address of the exit routine address of the HOBCOM operator commands 13 address of the HOBCOM password HOB HOBCOM under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM The numbers in paranthesis refer to error messages With the given number one can identify the errone ous pa
115. cess to PDS mem bers is only possible with PUN ne HOB HOBCOM under 5 OS 390 MESSAGES 11 MESSAGES 11 1 GENERAL REMARKS This manual contains two basic kinds of error messages those which appear only at the HOBCOM con sole and those which appear at user terminals Console messages can be found in the following chapters HOBCOM Direct Error Messages at the Terminal Console Messages XCT All other error messa ges belong to the group of messages which appear at the user terminal The first four characters in the error message indicate the name of the program from which the message originated For example ERROR NOTE0003 indicates that the program NOTE issued the message HOB MESSAGES HOBCOM under MVS and OS 390 11 2 HOBCOM CONSOLE MESSAGES ON THE HOBCOM TERMINAL PARTITION PROGRAM NOT SPECIFIED P1 P2 P3 or P4 has not been specified to indicate the partition or program Insert P1 or P2 etc in front of the command NO TASK GENERATED The user has attempted to enter UNLOAD or UNBATCH although no task has been genera ted on the corresponding virtual terminal Enter UNLOAD UNBATCH only for virtual ter minals in which tasks have been generated PROGRAM RUNNING IN SPECIFIED PARTITION TASK A program has been invoked in a partition or task in which a program is already running NO PROGRAM LOADED IN SPECIFIED PARTITION The user has attempted to terminate a program in a
116. command 01050001 The terminal has been switched off while printing Turn the terminal on and enter GO in the COBA 138 HOBCOM under 5 OS 390 MESSAGES 01050002 The printer has been turned off while printing Turn the printer on and enter GO in the COBA 01050003 Wrong Load parameters The print parameters entered in the TCT are incorrect 01050004 Attribute record duplicate Restart the print operation If this message appears again notify HOB Software Support 01050005 After the attribute record no normal record Restart the print operation If this message is displayed again notify HOB Software Support 00000011 is using the printer Wait a while and then reenter the print command ERROR PR020014 PAPPL IN COMMAND The parameter string for the LOGON command was incorrectly specified ERROR 020015 NO SAPPL xxxxxxxx IN COMMAND The parameter string was entered incorrectly when invoking program PR33770 Because no table with SAPPL entries was generated by the HOBCOM System a SAPPL entry must be made ERROR 20016 SAPPL xxxxxxxx NOT DEFINED A vitual printer name has been entered which has not been defined in VTAM ERROR 020017 SAPPL xxxxxxxx ALREADY ACTIVE The virtual printer VTAM node entered under SAPPL is already in use Re invoke PR3770 and enter a different SAPPL ERROR PR020018 SAPPL xxxxxxxx xxH During the OPEN of the VTAM
117. contact your system programer ERROR PR010036 INVALID QUERY COMMAND You made a typing spelling error while entering your command Please note that the command must be entered without further additions only QUERY PARAM 11 8 PR3770 MESSAGES ERROR 10000001 COMMAND IS INVALID The command entered is either incomplete or incorrect ERROR PR020001 PROGRAM IS BATCH P The selected program can only be invoked from the HOBCOM console You tried to start it from the HOBCOM console Use EXEC COBA to start a background task and then invoke program PR3770 ERROR PR020002 EITHER OUTFILE OR You may use only one of the two parameters for invoking ERROR PR020003 EITHER OUTFILE OR SFN3 You may use only one of the two parameters for invoking ERROR PR020004 INVALID OUTFILE FILE NAME The name entered at the parameter OUTFILE is wrong Compare the build up of the parameter in chapter Parameter at invoking ERROR PR020005 PRINTER PARAMETER NAME INVALID The parameter entered for the printer form is incorrect ERROR 020006 FREETIME UND PERM NOT ALLOWED Both the PERM and the FREETIME parameters were specified when invoking the program PR3770 These parameters are contradictory and may not be specified together ERROR PR020007 PARAMETER FREETIME IS INVALID The value specified after the FREETIME parameter is incorrect Valid entries range from 1 to 9999 ERROR PR020008 PARAMETER 2
118. d with the Return Code xx Refer to the VTAM Manual VTAM Messages Chapter Return Code Sense Fields and Return Code Posting Return Code Combination to find the cause of the error or inform the HOB Cu stomer Service ERROR PR020031 SET CONSOLE OFF ON ALL You have entered something other than OFF ON or ALL after the SET CONSOLE command 140 HOBCOM under 5 OS 390 MESSAGES ERROR PR020032 SEND INHIBITED NO SESSION The value entered after parameter PAGE is too large It must not exceed 999 ERROR 020033 SEND INHIBITED NO ALLOWANCE The RJE station is in the print or receive status and as a result cannot send commands to PO WER or JES To make entries you must first enter ATTN ERROR 020034 ATTENTION INHIBITED NO SESSION You have entered ATTENTION although no session is active An application must first be selec ted using the LOGON command ERROR PR020035 ATTENTION INHIBITED NO ALLOWANCE You have entered ATTENTION This action is blocked because a send command is being execu ted 11 9 MESSAGES OF THE XCTCPIP2 PROGRAM These error messages appear either in the HOBCOM basic mask NOTE or in the COBA NOTE PRVM PRT2 dependent on the print program that was started Example DRUCKER ERROR 01010505 or ABEN PROG PR3770 ERROR 020013 P E 01010505 Errors of the TCP IP of MVS x 501 Permission is denied No owner exists x 502 The data set or directory was not found x
119. data to this printer if the TCP IP printer LPD1 is addressed In XCPRT you enter the name LPD1 in the PRT parameter Inside HOBCOM the alias name is used EC PR3287 HOST 195 46 235 73 PRINTER SALIAS If the name you entered in PRI is not found in the XCTCT i e no XCPRT entry exists for this printer the name entered with PRI will be sent as TCP IP name Example EC PR3287 HOST 195 46 235 73 PRINTER LPD1 104 HOBCOM under MVS OS 390 HOBCOM AND TCP IP If your LPD doesn t allow you to rename the Windows name the XCPRT macro can be used to enter the Windows name as a string Example XCPRT NAME SALIAS PRT HL Laser Jet III PRINT 20 FFONE Note that blancs special characters and uppercase are allowed max 99 characters Example The following example shows how to print with the NOTE program on a LPD You can test if this printing works properly If not an error message appears in the status line of NOTE To invoke NOTE enter ER SALIAS HOST 1 1 1 1 The NOTE program window will appear Select function 4 to print the current screen ER PICTURE NR 1 FILE SNET 01010101 SALIAS If no error message appears the printer works properly Error messages you will find in section 11 9 MESSAGES OF THE XCTCPIP2 PROGRAM 9 4 2 Printing from PC over LPD on the host to HOBCOM To print over LP
120. e LOGMODE Informations with all of its model descriptions and then chooses the one that fits best With LOGMODE entries you need to watch entries like DEFSCREEN ALTSCREEN and ALTPAGE That means To define the real terminals that according to our examples use the logmodes D4A32872 and D4B32872 and the virtual printer that work with DSC2K or SCS the default group of the TYPETERM definitions i e DFHTYPE will be chosen TYPETERM definitions of the DFHTYPE group are found in the manual CICS VSE 2 1 Resource Definitions Online on page 302 If a Logmode that is not in DFHTYPE 04632792 for SNA extended datastream Model 2 or D4C32785 for SNA without extended datastream Model 5 shall be used for a virtual terminal then an own TYPETERM must be defined for this Besides this you must heed that at using such a logmode in VTAM the correct MODETAB was given at the definition of the virtual terminal SAPPL Example For a virtual terminal with SNA extended datastream and Model 4 a TYPETERM is prepared DFHLZ2E4 This expects SNX32784 as LOGMODE At the definition of the virtual terminal must in this case be heeded that the MODETAB is entered in which this LOGMODE given in the VTAM definition is to be found This is the case with MODETAB IESINCLM If no MODETAB is given with SAPPL VTAM uses the MODETAB ISTINCLM 3 6 2 TSO In TSO there are no corresponding tables the mode of the communication is taken from the B
121. e connection is broken x 521 The specified argument is too large x 522 The result is too large 523 The socket is in nonblocking mode and connection are not queued This is not an error condition x 524 The socket is marked nonblocking and the connection cannot be completed immediately This is not an error condition x 525 The socket is marked nonblocking an the previous connection has not been completed 526 A socket operation was requested on a nosocket connection x 527 destination address is required x 528 The message is too long The default is 8192 and the maximum is 32767 x 529 The specified protocol type is incorrect for this socket x 52A The socket option specified is incorrect or the level is not SOL SOCKET 142 HOB HOBCOM under 5 OS 390 MESSAGES x 52B The specified protocol is not supported x 52C The specified socket type is not supported x 52D Listen The socket does not supportthe Listen call 52 The specified protocol family is not supported x 52F The specified address family is not supported by this protocol family x 530 The address is in a timed wait because a LINGER delay from a previous close or another process is using the address x 531 Bind The specified address is incorrect for this host Connect The calling host cannot reach the specified destination x 532 The network is down x 533 The network cannot be reached x 534 The network dropped a connection on a res
122. e que ried for 1 Therefore the second action block is only executed when the first was succesful Format Length Length of comparing string minus 1 Length Condition Code 08 EQUAL Length Position of Comparing field 3FFF Screen contents Attributes special fields SMDSBLOK Length area of constants for Compares 6 16 3 Structure of the table SCDCRMA XCSCRMA XCSCRMH NAMI ELABEL PSCRMIE XCSCRMS EL 001 Action Action Action ENTRYIE XCSCRMS EL XCSCRMS E 76 5 05 390 TERMINAL CONTROL TABLE FOR HOBCOM XCSCRMC compare 3 RV compare 4 5 002 Action Action Action SUBENTRY2 PSCRMIE EQU DC AL2 0 6 16 4 The SMD BLOK EN MASK DEFINITION ECIAL REGISTER RTITION ID ZERO ERMINAL NAME B TERMINAL NUMBER ZERO 1 4 REEN SIZE ROWS COLUMNS RSOR ADDRESS FROM ZERO ERSON NUMBER PRIMARY APPLICATION N PRIMARY APPLICATION ID SECONDARY APPLICATION ID 6 16 5 Commands for the actions special key cursor position followes in 2 byte Format big endian set special register of SMDSBLOK 2 bytes follow re
123. ed description of the operator com mands To do this the macro XCOP must be invoked twice The first time XCOP is invoked the commands which can be entered from the console are determined the second invocation determines the commands which can be entered from any HOB E terminal Structure of the macro DIS YES NO SHU YES NO CP YES NO CAN YES NO DISC YES NO FILE YES NO TCTLOAD YES NO Each parameter determines the authorization for a certain command DIS DISPLAY commands are allowed SHU the SHUTDOWN command to end is allowed CP CP commands may be entered CAN the CANCEL command to end any HOBCOM task is allowed DISC the command to disconnect a HOBCOM task is allowed FILE the operator commands for word processing OPEN CLOSE and ACT DIR and the general operator commands 2 or BAT OFF TERM xyz are allowed TCTLOAD the command to reload a VCTCT is allowed The default value for each command is YES This means that if you invoke XCOP without specifing pa rameters all commands will be allowed The commands which are suppressed here can however be authorized for individual terminal groups see Chapter 5 5 parameter COMASK in the macro XCTE GRO Consult the HOB publication HOBCOM USER S MANUAL for the meaning of the commands 6 16 SCREENMASK With the function Screen Mask it is possible in
124. egisters ROO and RO1 may be changed all other registers remain unchanged Transfer of Date and Time If date or time should be asked for a routine will be jumped to whose beginning address is stored in field SA RDATE The registers are used as follows R13 addresses SA BLOCK 12 contains the date at jump back 11 contains the time at jump back HOB n TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and OS 390 R14 contains the jump back address 15 contains the jump in address SA WAITE Date and time will be given in european format packed with an additional zero in front of the prefix constant OC The registers ROO and R01 be changed all other registers remain unchanged Example The call is performed on 05 11 86 at 18 06 20 the first system parameter RSP1 contains hexa 0511860C the second system parameter RSP2 contains hexa 1806200C Output of a Message on the System Console message should be output on the system console first the routine is jumped to whose address is stored in field SA DISP1 With this invoke the address of a display storage is transmitted in which a maximal 64 byte long output message can be set up After that another invoke is done with BALR R14 R15 whereby the message is given out When Zero is given as address at the first invoke the first output of messages is not wanted and the second invoke must not be performed When a valid address is given at the first invoke th
125. en this 64 bytes large storage is pre initialized with blanks The registers are used as follows R13 addresses the SA BLOCK R12 contains the address of the 64 Byte long display field or zero at jump back R14 contains the jump back address R15 contains the jump in address SA DISP1 or after the first invoke the address of the second invo ke The registers ROO and R01 can be changed all other registers remain unchanged Example output of a message R15 SASDISP1 ADDDRESS DISPLAY ROUTINE R14 R15 DISPLAY FIELD RSP1 RSP1 SOMETHING PUT OUT PDENDE NO 0 20 RSP1 C THIS IS THE MESSAGE R14 R15 DISPLAY MESSAGE OH 7GO ON The following operations are strictly prohibited usage of relative address constants overwriting the HOBCOM storage e time dependent operations i e disk access setting the timer 72 HOB HOBCOM under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM change the program and then reloading the TCT while HOBCOM is operating An example for the use of the UPNAM macro is contained in your TCT It appoints LU address out of a pool A printout of these routine is in the appendix of this manual 6 15 AUTHORIZATION FOR HOBCOM OPERATOR COMMANDS XCCOMASK Beginning at the label XCCOMASK you can define authorizations for the use of HOBCOM operator commands consult the HOBCOM User s Manual for a more detail
126. end f r LISTEN completed mit IPAUDIT 0 x 595 GETSOCK routine liefert f r ACCEPT keine SOCKET NR x 596 IUCV Send f r ACCEPT fehlerhaft 597 IUCV Send f r ACCEPT completed mit IPAUDIT 0 x 598 IUCV Send f r CONNECT fehlerhaft x 599 IUCV Send f r CONNECT completed mit IPAUDIT 0 x 5A2 IUCV Send f r CANCEL fehlerhaft x 5A3 IUCV Send f r CLOSE fehlerhaft x 5A4 IUCV Send f r CLOSE completed mit IPAUDIT 0 x 5AA Send f r GETPEERNAME fehlerhaft x 5AB IUCV Send f r GETPEERNAME completed mit IPAUDIT 0 x 5B4 IUCV Send f r WRITE fehlerhaft x 5B5 IUCV Send f r WRITE completed mit IPAUDIT 0 x 5BE IUCV Send f r READ fehlerhaft x 5BF IUCV Send f r READ completed mit IPAUDIT 0 x 5C9 GETSOCK routine liefert f r SOCKET keine SOCKET NR IUCV Send f r SOCKET UDP fehlerhaft x 5CB IUCV Send f r SOCKET UDP completed mit IPAUDIT 0 x 5D2 IUCV Send f r SENDTO fehlerhaft x 5D3 IUCV Send f r SENDTO completed mit IPAUDIT 0 x 5DC IUCV Send f r RECVFROM fehlerhaft x 5DD IUCV Send f r RECVFROM in 30 nicht completed x 5DE IUCV Send f r RECVFROM completed mit IPAUDIT 0 HOB 145 MESSAGES x 5E6 IUCV Send f r CANCEL fehlrhaft 5 L nge feld mit Host Adresse falsch DNS response x 5F1 kein TCPIP OPEN da shutdown l uft x 5F2 IUCV Connect mit TCPIP fehlerhaft x 5F4 Send Initial Message fehlerhaft x 5F5 IUCV Sever empfangen x 5F6 Name zu lang
127. er than 64 characters Use an abbreviated form for each parameter WRONG TEXT AFTER USSTAB COMMAND You entered a text after the abbreviated command Enter only the abbreviated command USSTAB COMMAND WRONG GENERATED The command abbreviation is wrongly defined in your HOBCOM TCT Please check your entry and if necessary contact your system programer 128 under 5 OS 390 MESSAGES 11 5 COVTC COVTOP MESSAGES ERROR 10000001 COMMAND IS INVALID The command entry was incomplete or incorrect ERROR COVT0001 PAPPL IN COMMAND The parameter string was not entered when invoking the program COVT ERROR 0002 NO SAPPL IN COMMAND The parameter string was not entered when invoking the program COVT Since a table of SAPPL entries was not generated in the HOBCOM system a SAPPL must be entered ERROR 0003 You can build your own Exit Routines into your XCTCT that give back error codes These are put out under these error numbers ERROR 0004 SAPPL xxxxxxxx NOT DEFINED The virtual terminal name entered has not been defined ERROR COVT0005 SAPPL xxxxxxxx ALREADY ACTIVE The virtual terminal VTAM node is already being used for a different purpose Recall COVT and enter a new SAPPL ERROR COVT0006 SAPPLzxxxxxxxx OPEN ERROR xxH Program COVT or COVTOP found an error while opening the VTAM ACB Consult the VTAM Manual to find the cause of the error o
128. erminal This terminal can com municate only with the program HOBCOM and as a result logon commands cannot be passed directly to VTAM The terminals are logged on directly to HOBCOM with the support of terminal definition in VTAM In order to assure that the terminals will be automatically shut off in case HOBCOM has not been started or if for some other reason HOBCOM is not available a USSTAB should be defined The content of the USSTAB is sent to the terminal if the terminal is not logged on to HOBCOM The real terminals are defined in VTAM as IBM 3278 model 2 terminals Example of a NON SNA definition CUADDR 380 TERM 3277 D LOGMOD S3270 EATUR2 MODEL2 NOSELPE ISTATUS ACTIVE LOGAPPL HOBCOM USSTAB USSTABN2 Example of a SNA definition 0800 VBUILD TYPE LOCAL COP00 PU CUADDR 3A0 S02 LU LOCADDR 002 SSCPFM USSSCS DLOGMOD D4A32782 ISTATUS ACTIVE LOGAPPL HOBCOM USSTAB USSTABSA 3 2 1 LOGMODE for SNA and NON SNA Terminals The communication mode between terminal and application program here HOBCOM is specified with support of logon mode tables The same logon mode used for the IBM 3278 model 2 terminals should be choosen for the HOB E termi nal VTAM Standard MODETAB ISTINCLM entries can be used the logmode used depends on the control unit If the terminal HOB 88 E 89 is to be connected to a NON SNA unit the entry 3270 or
129. ess 12345123123 Terminal Device Cancel Help du Remote m Local Port Automatic Port Assignment ze v Use TN3270 Extended Protocol Resource Device 23 5 05 390 HOBCOM AND The XCTPRI Macro With the help of this macro the printer driver 100 is assigned to a 3270 printer S protocol that is man aged by HOBCOM and the LU type is determined Now you can print on a S printer from HOBCOM under MVS if it is connected over TCP IP If a TN3270E printer session is built to MVS HOBCOM this printer can be made known to HOBCOM by the macro XCTPRI As it can be used in VTAM HOBCOM to define an SNA printer Note If the macro is not entered in the HOBCOM recognizes the type TN3270 SNA automati cally when the printer is connected The macro is required only if you wish to use the non default values Sample entry ERM nameabc E TN3270 PRINT 100 LUTYPE 1 DISCON NO ERM namexyz E SNA PRINT 20 LOGM DSC2K DISCON NO LASTTI HOB 99 AND HOBCOM under MVS and OS 390 TERM This parameter is mandatory It corresponds to the resource device name used in TN3270E or the name of the VTAM LU in SNA With the help of this name the printer is addressed inside HOBCOM TYPE SNA SNA is the default val
130. essary examples in the appendix In this table the Baudrate can be adjusted printer types are defined in the following form PRINTxx X 00xx x 00 C S COP006 ER PROGRAM You can make a further entry with the wanted Baudrate when necessary The terminal will then be adju sted to this Baudrate when turned on Following entries are for the diverse baudrates HOB 47 TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and 05 390 Entry Baudrate X 00 110 X 02 300 4 600 X 06 1200 X 08 2400 X 0A 4800 9600 19200 According to the Terminal the number of the extra entered printer types is then to be entered under the XCTERMA label XCTERMA TERM TERM555 PRINT xx The Driver 20 The Driver 20 manages the same printers as the driver 10 By this new driver instead of the ROMAN 8 font the font PC 850 is used It should always be used when HP printer are used together with HOBLink 3270 HOBLink 3270 sends this driver as default In the HOBCOM TCT the driver should be registered as follows PRINT20 EQU ER ART 20 0020 20 X OE x 00 X SCOP0020 The Driver 100 It is possible to adress a S printer with a normal 3270 data stream from MVS HOBCOM Prerequisite is a bind to VM HOBCOM over TCP IP To do this in MVS HOBCOM the driver
131. et x b35 The software caused a connection abend x 536 The connection to the destination host is not available x 537 Accept Not enough buffer space is available to create the new socket Send Not enough buffer space is available to send the new message x 538 The socket is already connected x 539 The socket is not connected x 53A A send cannot be processed after socket shutdown x 53B There are too many references A splice cannot be completed x 53C The connection timed out before it was completed x 53D The requested connection was refused 5 There are too many symbolic loops levels x 53F The file name is too long 540 The host is down 541 There is no route to the host x 542 The directory is not empty 543 There are to many process in the system x 544 There are too many users on the system x 545 The disk quota has been exceeded 546 A STALE NFS data set handle was found x 547 There are too many levels of remote inthe path 548 The device is not a stream device HOB 143 MESSAGES HOBCOM under MVS and OS 390 x 549 The timer has expired 54 There are no more stream resources 54 There is no more message of the desired type x 54C The system cannot read the message x 54D The identifier has been removed 54 A deadlock condition has occurred 54 No record locks are available x 550 The requested machine is not on the network x 551 The object is remote 552
132. eter character one byte and a parameter value The following pa rameter indicators are in use feature code specified in 2 bytes 2000 No Graphic mode This entry is valid for printers with graphic capabilites e g the HOB 8 LP and the HOB 150 IP This entry is necessary if no graphic characters are to be printed and if values which indicate the si ze of the print for example horizontal spacing vertical motion index are set differently for HOBCOM and for the printer blank page suppression this means that the printer issues no page feed if it is already in the first line Hex Feature means that the two characters following X 5H are interpretted as hexade cimal values In order to specify several features values are added For example C000 4000 empty page suppression 8000 Hex Feature copy count the number of copies the user wants including the original is specified in one byte The default value is 1 LPP lines per page The number of lines per page are specified as a binary number in a half word 0 to 32 000 This value is not passed to the printer instead it is used as an internal program counter The default value is 72 If LPP 0 is specified the program sends a page feed without the logic If LPP 1 is specified the program does not send its own page feed ZES is the line number of the first line of each new page The line number follows as a binary number in a half word The program sends sever
133. f next print record X 0140 Feed PPFORM2E 2 Hex values can be passed to the printer order to be able to use special functions 80 characters per line are to be output XPRPDEF NAME FSP10H FEATURE HEX SPACING 10 or XCFOR ABB FSP10H PAR FF028000150A 3 80 is to be the maximum line length and 24 lines per page are to be printed XCFOR ABB LEN80 PAR FF1650110018 HOB 59 TERMINAL CONTROL TABLE FOR HOBCOM under MVS and OS 390 6 9 TABLE WITH BATCH TASK COMMANDS XCUSSBTA The batch task commands for automatically starting and stopping tasks are entered after the label XCUSSBTA This allows to start a task automatically as soon as a screen is switched on or off respecti vely a connection of a end device to HOBCOM Beyond it is the starting of tasks not possible when you start HOBCOM The commands are entered by using the macro XCUBT or or TERM TASK CO 60 ERM terminalname TASK taskname SYSTEM YES NO CO YES NO COM command ERM terminalname TASK taskname ERMSTA YES NO ASKSTA YES NO CO YES NO COM command XCUBT TASK taskname PERSNO personalnumber BTPRI YES NO COM command terminalname Name of the real terminal as entered after the label XCTERMA This name with the maximum length of eight characters is simultaneously the name of the task if n
134. f the printer program invoke with a given printer name gt XFDOO b a comparison of the terminal driver out of the printer program invokes with the given driver gt X FDO1 The following print directions will only be given in agreement Example so HOB HOBCOM under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM DC AL1 PPFOR32B PPFOR32A LENGTH PPFOR32A EQU BEGIN OF LINE DC X FDOO ITION DRIVRE DC X 001000 10 X 01 PPFOR32B 1 The feed only happens when for the terminal on which the chosen printer is attached to driver 10 for laserprinter is entered HOB 57 TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and 05 390 X02 4000 8000 10 X11 12 X13 14 X15 16 this feed byte contains the same values as X FF however only the parameters which were previously set are changed This indicator can also be specified in a text if a pa rameter with hex feature is used LPP lines per page and VMI vertical motion index may not be changed e g FE 13 0A sets the left margin to the 10th column printer adjustment parameters can be passed in this data record These values are con verted by HOBCOM to the printer specific control characters They are also used as HOBCOM internal counters A data record consists of individual parameters which in turn consist of a param
135. formed of this through the parameter data s Example LOGON APPLID application name DATA S At the definition of a real terminal an application name for the LOGON can be transfered but not the parameter DATA S Therefore a standard IBM terminal that should logon immedeately to HOBCOM with LOGAPPL HOBCOM must get an entry in the in macro XCTSTE see chapter 5 to identify it as a S terminal We recommend to enter a real standard IBM terminal without LOGAPPL Entry but with a VTAM USSTAB command with which the parameter DATA S is transferred Example for a SNA terminal HOBC USSCMD CMD HOBCOM REP LOGON FORMAT PL1 USSPARM PARM APPLID DEFAULT HOBCOM USSPARM PARM LOGMODE DEFAULT HOBLMEO2 USSPARM PARM DATA DEFAULT S OPT Example for a NON SNA terminal USSCMD CMD HOBCOM REP LOGON FORMAT PL1 USSPARM PARM APPLID DEFAULT HOBCOM USSPARM PARM LOGMODE DEFAULT D4B32782 USSPARM PARM DATA DI ULT S 3 1 2 Defining a 3270 Printer The definition of a 3270 printer is principally the same as the definition of a standard IBM terminal As a printer can t use an USSTAB command to logon it must always be defined with the help of the macro XCTPRI in the XCTCT see chapter 5 under MVS OS 390 DEFINING TERMINALS AND PRINTERS 3 2 DEFINING THE REAL E TERMINALS IN VTAM The HOB E terminal is to be defined in VTAM as an IBM 3278 Model 2 t
136. hich mode of commun ciation is being used TSO and VCNA are examples of application programs that do this other pro grams e g CICS generate the BIND parameters themselves and do not query the default values DLOGMOD D4C32782 The above parameter should be specified since the virtual terminals are by defintion SNA terminals regardless of how the real terminals are defined If a terminal is to operate in the 7 color mode using COVTC the logmode D4C32792 is to be substitu ted for the logmode D4C32782 If this entry is not contained in your standard MODTAB the entry from the MODTABCO can be used In addition to MODTAB MODTABCO the following entry must be made DLOGMOD D4C32792 under MVS OS 390 DEFINING TERMINALS AND PRINTERS 3 6 DEFINING THE VIRTUAL TERMINALS IN THE APPLICATIONS The virtual screens always communicate as SNA units LUTYPE 2 even if the real terminals are con nected to a NON SNA control unit Output Chaining i e splitting up the output messages into several blocks which must be executed for the SNA control unit is not necessary and is suppressed 3 6 1 CICS There are two possible ways to define real terminals virtual terminals or virtual printers in CICS 1 through an entry in the CICS TCT 2 automatic generating using AUTOINSTALL or RDO With AUTOINSTALL an entry is generated in the CICS TCT at the moment of LOGON that is erased at LOGOFF This method is only
137. his case For the NC print the port number is required The definition of the NC printer in the XCTCPIP table LPD XCTCPIP DS OF XCPRT NAME name PRT printername PRINT drivernumber FFONI XCTCPIP DS OF XCPRT NAME name PORT portnumber PRINT drivernumber FFONI 106 HOB HOBCOM under MVS OS 390 HOBCOM AND TCP IP NAME name is the name of the printer as specified inside HOBCOM printeralias You can choose any name you want When you invoke a HOBCOM program this name can be referred PRT printername is the name of the printer on the remote system PC PORT portnumber is the number of the port on the remote system that was opened for the printer there PRINT drivernumber is the number of the driver program as entered in the XCPRTAB for the driver program FFONEND The FFONEND FormFeed on End parameter is optional 9 6 PRINTING ON A USER NAME It is possible to enter a printer batch task in the TCT that doesn t contain the name of the printer perfor ming the output HOBLink J Term can create a connection to HOBCOM without specifiing a device or resource ID Nor mally HOBCOM can start only one batch task per terminal If HOBLink J Term send no resource ID the terminal name for this HOBLink J Term is generated by HOBCOM On this name the print can be output As the name is not known before the connection the definition of a printer task is not possible The XCUBT macro has two parameters
138. in the PSETUP on the PC under PSEUDO LU NAME is defined in the HOBCOM TCT with a wrong Macro Please register the Terminal with the macro XCTLTS XCTEOS304 ID xxxxxxxx INVALID LTKEY LT KE Y XXXXXXXX The in theHOBCOM TCT declared LTKey is different to the LTKEY in the PSETUP on the PC XCTE0305 ID xxxxxxxx INVALID PU TYPE LT xxxxxxxx PU TYPE xx 126 HOBCOM under 5 OS 390 MESSAGES 11 4 COBA MESSAGES FUNCTION NOT DEFINED The function number entered is not listed in the menu NO STORAGE AVAILABLE The main storage managed by HOBCOM is full Increase the value of the SIZE statement for the partition or class in which HOBCOM is running Refer to the Installation Guide SYNTAX OF TASK NAME NOT CORRECT The task name entered does not start with a letter Task names must start with a letter and can have a maximum length of eight characters TASK NAME ALREADY IN USE The task name selected is already in use TASK NOT FOUND The user has attempted to establish a connection to a nonexistent task via function 2 CON NECT TASK TASK IS ALREADY CONNECTED The task entered is already running on another virtual terminal A PROGRAM IS ALREADY ACTIV The user has attempted to invoke a program in a task in which a program is already running WRONG TEXT AFTER THE COMMAND Text has been entered after the command CANCEL The command must be entered without any text IN THIS PART NO PROGRA
139. ion VTAM Reference Summary SNA Reference Data XCTEOO006 ID xxxxxxxx RECOVERY Terminal xxxxxxxx was switched off or disabled as a result of an error and is now being resyn chronized XCTM0007 ID xxxxxxxx DISCONNECT The session between and the terminal has been ended 0010 ID xxxxxxxx LU xxxxxxxx LOGON ERR DUPLICATE TERMINAL With E or Terminal you tried to connect to HOBCOM although the name in the HOB COM TCT with the macro XCTLTS is registered for Laptop slave 0011 ID xxxxxxxx LOGON ERROR ALREADY OPENED You have tried to logon a terminal whose name already exists 0012 ID xxxxxxxx LOGON ERROR INVALID LOGON MESSAGE While LOGON to a S Screen to HOBCOM over the parameter DATA a LOGON message was sent XCTM0013 ID xxxxxxxx LOGON PARAMETER FROM LOGON MESSAGE S xx While LOGON of an S Screen to HOBCOM the LOGON message S xx was sent 0014 ID xxxxxxxx ERROR S TERMINAL BIND PARAMETER While connecting HOBCOM to an S Terminal from VTAM it became a wrong Bind e g VTAM sends the Bind for model 1 These can t be processed by HOBCOM XCTMO0015 IDzxxxxxxxx S TERMINAL NUMBER OF SESSION EXCEEDED The number of S Sessions declared in the HOBCOM Password was crossed XCTMO0016 ID xxxxxxxx LAPTOP NOT ALLOWED PASSWORD In your HOBCOM Pasword the LOGON of a PC or Laptop over HOBCOM Asynchron is denied HOB 121 MESSAGES HOBCOM under MVS and OS 3
140. itions are entered after the label XCUSSOUT You can change these to fit your needs You may use all 256 byte values since the output is in HOB mode The length of the output is contained in a half word followed by the output message The standard TCT contains explanations of the command abbreviations inside a frame This output mes sage has a length of 7 screen lines The length of this part of the mask is defined in a half word 7 X 80 characters 560 Bytes DC AL2 560 Your own frame design may not exceed 14 screen lines line 22 is reserved for data entry AL2 1120 The length of the mask determines how many lines of ouput messages you will be able to view on your screen The more lines you have defined the less you will be able to see of the output messages If you wish to see the output messages press the PF2 key This removes your mask from the screen making the output messages visible pressing PF3 returns your frame to the screen The following character definitions might be helpful to you when you are designing a screen layout X11 upper left hand corner X 1B horizontal line X52 upper right hand corner X56 vertical line X12 lower left hand corner X53 lower right hand corner In the appendix you will find a description of all signs available for the modus TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and OS 390 6 7 TABLE WITH ABBREVIATIONS XCUSSCOM After the label XCUSSCO
141. kckck ck ck ck ck ckokokck HH ck ck HH HH HH ck ckckckokckokckck ck ck ckckckokokckck ck ck ck ckckckokokokok PROGRAMM XCTCT CSECT XCTCTANF XTCTGEN TERMA XCTERMA PRTAB XCPRTAB ACBNAM HOBCOM TEGRO XCTEGRO USSOUT XCUSSOUT USSCOM XCUSSCOM PRPAR XCPRPAR USSBTA XCUSSBTA PERSTA VCPERSTA JCLTAB XCJCLTAB COMASK XCCOMASK LTKEY ABCD1234 PASSW XCPASSW PX DS OF ADRESSES OF TERMINALS 01 10 XCTCT TERM N02 PRINT 06 X GROUP G1LABEL XCTEGRO 08 06 X GROUP G2LABEL XCTEGRO X LASTTE YES XCTEGRO DS OF DC DC Y XCTEGROE XCTEGRO LENGTH OF TABLE XCTEGRO LABEL G1LABEL NAME GRUPPE1 USSOUT G1USSOUT XI USSCOM G1USSCOM XCTEGRO LABEL G2LABEL NAME GRUPPE2 USSOUT G2USSOUT XI USSCOM G2USSCOM COMASK DISC XCTEGROE EQU G1USSOUT DS OF OUTPUT DC AL2 xxx LENGTH OF OUTPUT DC x 01 CORNER DC 5X O0B HORIZONTAL LINE DC CL7
142. macro XCJCL1E without parameters to close a JCL definition Example HOBCOM under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM XCJCLTAB DS XCJ XCJ XCJ XCJ XCJ XCJ XCJ XCJ XCJ E TESTJCL USER VSE1 CLASS A INE JOB JN JOB1 DISP D CLASS A E LST DISP D CLASS C DEST USE E PUN DISP I CLASS A PRI 6 x EXEC LNKEDT f e EU QO00000000 DC This way the job JOB1 is set into the POWER of the VSE machine HOBTT14 and starts according to the powerclass A This JCL is spoken to with the name TESTJCL The Macro XCJCL2 determines the name of the JCL NAME Afterwards different macros can be used XCJCL2 XCJCL2J XCJCL2E XCJCL1LA and XCJCL1LE DC optional entry text blocks for Dynalloc These blocks are defined according to the ma nual OS VS2 MVS System Programming Library Job Management After the XCJCL2 macro several text blocks may be given If the HOBCOM program that this JCL speaks to doesn t need text blocks these will be ignored XCJCL2J This macro ends text blocks It must always be given even when no text blocks have been defined XCJCL1A LINE lines given with this macro will be given at the start of the output Lines with XCJCL1A must not be present XCJCL1E LINE Lines given with this macro will be given at the end of the output A macro XCJC
143. mandation RCF 1001 1002 but not TOP NetBIOS In every Windows Domain exists a Primary Domain Controler PDC Further is a WINS server responsi ble for the arrangement of the TCP IP addresses to the Windows namen inside of the domain HOBCOM communicates with the WINS server and this one with the PC It forwards the print data also over TOP NetBios to the printer Necessary definitions on the PC The PC that will be used for printing should be connected with a local printer and Windows has to be defined The PC must know the printer 108 HOB HOBCOM under MVS OS 390 HOBCOM AND TCP IP You have three possibilities a You need no authorization to adress the printer no password is given b You need a password to adress the printer All users knowing this password are able to print on it c only under NT only certain users of the domain are able to adress this printer with userid and password The user who wants to adress this printer has to be registered on PDC as user in this case HOBCOM represents to the PDC as user The corresponding userid and the passord will be entered in the HOB COM TCT at the macro XCSMBDD The PC has to be announced at a WINS server The WINS server HOBCOM is calling has to know this PC with printer Necessary definitions in the HOBCOM TCT HOBCOM announces oneself in the Windows domain with a own ID Parameter HCNAMED by XCSMBDD You can choose it and it has not to be defined in the Wi
144. mmand D STOR may be useful The priority of the HOBCOM partition should lie between that of VTAM and other VTAM applications In other words HOBCOM should be given a lower priority than VTAM and it is advisable to assign HOB COM higher priority than CICS and other similar VTAM applications Before the HOB terminals can be operated the following steps must be executed a define the major node HOBCOM b define the real terminals in VTAM define the virtual terminals in the applications 2 define the virtual printers in the applications connect the terminals 2 f load the magnetic tape fit the HOBCOM TCT start HOBCOM under MVS OS 390 INSTALLATION GUIDE 2 2 LOADING THE MAGNETIC TAPE You receive a magnetic tape to install the HOBCOM programm phase and to load the VTAM tables 2 2 1 Content of the HOBCOM installation tape Standard HDR Label EOF HDR HOBCOM EOF EOF MACLIB LIB1 There are 3 libraries on the HOBCOM installation tape HOBCOM LOADLIB HOBCOM MACLIB HOBCOM LIB1 HOB XCHOBCOM XCHOBCST HOBCTCT MODTABCO MODTABCX MODTABLT 055 1 USSTABN2 055 51 055 52 USSTABSA USSTABX USSTABLT JXXXX LOAD Bibliothek contains the programm phases XCHOBCOM and XCHOBCST main program that is started via job control is reloaded to start sub tasks M
145. n you have entered a password for HOBCOM special functions among other things the ACB name will be compared in this password An example XCTCTANF XTCTGEN ACBNAM HOBCOM TERMA XCTERMA TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and OS 390 6 3 TABLE WITH TERMINAL ENTRIES XCTERMA After the XCTERMA label the E Terminals and Token Ring Terminals names will be entered These entries are necesary so that the HOBCOM can tell which type terminal it is and which printer type is connected to which terminal Any number of terminals can be defined at one time The terminals are defined with the VCTCT macro The following entries are needed for E Terminals entries in paranthesis are optional ERMA DS OF ADDRE P ERMINALS XCTCT TERM terminalname PRINT printertype DISCON YES LASTTE YES terminalname name 8 characters in length can be entered as terminal name This name appears in the HOBCOM console as terminal name Enter the terminal address with which it was dedicated to the virtual machine If remote terminals are to be defined enter a channel number which does not exist For different remote transmission lines use different channel numbers or construct a virtual control unit for each remote transmission line Control units have up to 32 addresses beginning with 00 20 40 60 80 to EO printertype the printer type
146. nd OS 390 LTKEY ABCD5678 3rd byte of LTKEY 56 0101 0110 inverted 1010 1001 9 LTKEYP AB gt Host Password ABCDA9AB under MVS and OS 390 TERMINAL CONTROL TABLE FOR HOBCOM 6 4 TABLE WITH PRINTER TYPES XCPRTAB The existing printer types can be found after the XCPRTAB label These Entries remain unchanged The following printer types are available TCT Entry 0006 0007 0008 0009 0010 0011 0012 0042 0049 0099 Printer Type Siemens Mannesmann Mannesmann Epson without graphics feed 1 180 inch HP Laser also Mannesmann Kyocera and Epson with HP emulation typewheel printer Epson with Grafik feed 1 180 inch also Mannesmann and HP Laser with Epson emulati on Epson with graphics feed in 1 216 inch also Mannesmann Kyocera and HP Laser with HP emulation Epson without graphics feed in in 1 216 inch other printers HOB Printer HOB 150 IP 200 IP HOB 270 B 4001 140 look 0012 HOB 4 LP 6 LP 8 LP Il resp 8 LP III resp IIl D 16 LP HOB SM 13 HOB 220 MPQ 220 MP resp MP 2 270 F 275 MPQ resp MPQ 2 350 MP 540 IP 550 IP 8 LP emulation 220 IP 2 EZ NEC emulation 120 180 20 1060 LC 6 LP Epson emulation HOB 220 IP HOB 240 IP 450 B with barcode module 500L If you must add non existing printer drivers into your TCT i e at changes of CODIS on HOBCOM you can find the nec
147. ndos domain A domain name is sent Parameter DOMAIN by XCSMBDD which you can also choose The following definitions are ne cessary in HOBCOM TCT a The domain is naimed where the destination printer is located The domain is written with the macro XCSMBDD Several XCSMBDD descriptions are possible These are located in a new table which you have to create To create this table you have to the parameter SMBDOM by the macro XTCTGEN XTCTGEN SMBDOM XCSMBDOM The table will be inserted in the TCT but a end marking is necessary XCSMBDOM DS OF XCSMBDD XCSMBDD DC AL2 0 end marking b The printer is described with the macro XCTPRSMB This macro is called in the table XCTERMA ERMA DS OF NAME tes LASTTE end marking of the table The name of the printer is given when you call the printing program e g PR3287 with the parameter PRI or OUTFILE Example PR3287 SA PA PRI test10 109 HOBCOM under MVS and OS 390 The Macro XCTPRSMB The following parameters are possible TERM PRINT SMBDOM NOSESS TYPE PCNAM PCPRINAM PW PROT LASTTE is the name of the printer inside of HOBCOM You can choose this name and it is given at the program appael with the parameter PRI or OUTFILE Here you specify the treiber code number e g 20 of the treiber with that HOBCOM
148. ne are as follows corresponds to the bypass characters F1C2 correponds to the ASCII escape sequence 1B which marks the beginning of a control character 5093F1D7 are EBCDIC codes which are to be translated to ASCII in this case amp 110 If more than one initialization sequence is to be passed in a 90 line then each ASCII escape sequence 1B and each character with a hexadecimal value less than X 40 must be coded with a bypass charac ter Please observe that this sample parameter is not complete Intilaization sequences for page length line spacing number of lines per page the left and right margins as well as the supression of blank lines are missing under MVS OS 390 PRINTING WITH HOBCOM 8 2 PRINTING FROM CICS ON E TERMINAL PRINTER The programm PR3287 allows you to print CICS data direct on a terminal printer To do this the following definitions are necessary in VTAM Define the printers in the VTAM major node Example APPL ACBNAME NOIP AUTH ACQ NOPASS VPACING 1 EAS 2 in CICS Define the printers in CICS as either LUTYPE 1 or LUTYPE 3 Example for LUTYPE 1 DFHTCT TYPE TERMINAL ACCMETH VTAM RMTYPE SCSPR TRMMODL 2 COMPAT NO ERRATT NO ESIZE 24 80 ESTAT AUTOPAGE L 255 160 RECEIVE NOIP ETNAME NOIP PRTY 0 xx MK PX PX PX PX
149. nes as well as during print data transmission Through a number of HOBCOM operator commands one can be informed of the condition of HOBCOM uses at any time It is possible to test your own terminal contents or those of other users for errors with the extra program STTE It can be used by the central User Service for optimal telefonical help As VTAM application HOBCOM can communicate with PCs Laptops as well that use the emulation HOBLink for HOBCOM HOB HOBCOM under MVS OS 390 GENERAL REMARKS asynchron The PC communicates via the asynchrone interface via modem oder via accustic cuppler with a PAD that translates the data stream in X 25 protocol The data stream then reaches HOBCOM over NCP and NPSI and thus enables your PC the same advantages as a HOB E terminal HOBCOM works together excellent with the HOB emulation HOBLink 3270 As transfer protocol an HOB specific protocol the Y protocol is used This protocol is similar to the HOB X protocol but it allows additionally data encryption a better copression and a faster transmission of the data HOBCOM under MVS supports TCP IP and allows printing on a print client LPD and the communicati on with TN3270E applications terminal and printer Here HOBCOM serves as a gateway between the SNA data stream on the host and the IP in the net You will find a detailed description of the HOBCOM programs COBA NOTE COVTC COVTOP PR3287 and PR3770 in the HOBCOM User s Manual 1
150. number ERS NO 00000055 TYPE P AME MUELLER PW PASSWORD ENKEY Key ENFULL YES COMASK TEXT CP SHU CAN DISC FILE TCTL STT XCUBT TASK HUGO PERSNO 00000055 COM EXEC PR3287 The task HUGO is started when a person MUELLER logs on HOBCOM Example XCUSSBTA DS XCUB E 01 TASK PRINTI X EXEC PR3287 5 5 01 01 5 01 TASK PRINT1 A NO SKSTA NO SHUTDOWN HOBCOM under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM Please note that there may be no blanks between the parameters at command invoke This danger exists especially with continous lines write through to Besides certain paramters can be set or changed with the help of the COBA program even after starting the task i e through the command SET PARAM fsp1 0h LOGON PAPPL or SET PA More information for this you ll find in the paragraphs of the corresponding batch programs in the HOBCOM manual Command invokes can also be devided This is a special advantage when batch tasks have to be newly started with the help of ON HOBCOM operator commands because of a CICS Example XCUBT TERM NO1 T TT X PR3287 5 01 1 01 TASK PRINT1 TASKSTA NO
151. o eee ff ggg hhh eee ff ggg iii TCP IP addresses of the target host The XCPRT macro makes it possible to give the printer on the target host an alias name printername Name of the printer on the target host Under circumstances the target host expects that this name is in lowercase Then here the name has to be entered in lowercase too In this case in HOBCOM only the alias name can be used because HOBCOM command entries are automatically changed to uppercase printeralias HOBCOM name of the target printer Starting the LPD print The following HOBCOM programs can be used to print on LPD NOTE PR3770 and PR3287 If the TCP IP print is to be started the parameters HOST and are required when this print pro grams are used or the parameter OUTFILE alternatively Examples 102 HOB under MVS and OS 390 targethostname targetdomainname targethost printername name1 HOBCOM AND TCP IP EXEC PR3287 HOST targethostname targetdomainname PRI printerername AGO EXEC PR3287 HOST targethost PRI printername EXEC PR3287 HOST namel PRI printernam Name of the target host as it is entered in the name server Name of the target domain as it is entered in the name server This name is divided by a dot Example HOST qqq rrr ss Hostname qqq Domainname rrr ss the TCP IP address of the target host Example HOST 222 33 444 5 Name of the printer in the t
152. o 63 01 to X 3F which indicate multiples of 1 12th of an inch The byte X 00 isollowed by an atrribute which is valid until the next attribute parameter is encountered see above for attribute structure A special attribute record feed X 81 may not be specified for such a record HOB ss TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and OS 390 X 8C the following half word 2 bytes is interpretted as the number of the paper cassette or paper bin for printers with 2 sheet feeders or more X 8D the following half word is interpretted as a feed The value is specified as a multiple of 1 48th of an inch When the next page feed takes places the correct positioning at the beginning of the page takes place X 8E a feed to the end of the current page takes place If a page feed follows it is ignored X 8F all stored lines which have not yet been output are printed The data record after the feed byte is ignored X 8F all saved not printed records will be printed The record after the feed byte are ignored X 90 the characters following this value are sent directly to the printer without be evaluated This allows you to specify control characters for your printer the following half word 2 bytes will be evaluated as shaft nummer two page entry The following characters will be exchanged at printing This way a german character can be exchanged for a french character or for a graphic char
153. o other name is entered with the parameter TASK taskname Any name with a maximum length of 8 characters can be entered as task na me If you do not enter a name here HOBCOM uses the name that is specified under as taskname You only have to define this parameter when se veral tasks from one screen should be started YES NO CO YES When this parameter is set you are allowed to feed exclusive HOBCOM com mands by respectively BAT ON OPEN see below The input of batch task commands 1 possible The parameter TASK can t be used if CO is set YES CO NO HOBCOM under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM COM SYSTEM TERMSTA TASKSTA BTPRI HOB This is the default value If COz is set NO you can declare a batch task command which starts a task by COM Examples EXEC SHUTDOWN CANCEL LOGON SET PARAM command Declare a HOBCOM command or a batch task command Note that the para meter CO appropriate You can order the starting or ending of a batch programm with the commands EXEC or SHUTDOWN The command must always be enclosed in apostrophes HOBCOM operator commands can t be specified YES NO SYSTEM YES With this parameter the batch task can be immediately started when the HOB COM is activated on This ex cludes the parameter TERMSTA and TASKSTAz SYSTEM NO This is the default value The stated task won t be started by activating HOB COM
154. o send init sequences from HOBCOM to a printer HOBCOM has to know which printers are connected This information is entered in HOBCOM over the driver number e g 10 for HP Laser LPD can be con trolled by a HOBCOM driver too This makes it possible to avoid problems with special characters face types line space etc To do this in the XCPRT macro the PRINT parameter is used Example XCPRT NAME Sprinteralias PRT printername PRINT drivernumber drivernumber is the driver number as entered in you TCT for a certain driver program e g 20 for COP0020 or 98 COP0098 If the entry XCPRT is missing no driver will be used If the PRINT parameter is missing the default value driver 98 will be used Note Please note that in this case an entry for the driver 98 in your XCTCT in the table XCPRTAB is necessa ry Some LPDs or applications don t send a form feed at the end of the print With the XCPRT macro this form feed will be added and thus the last side of the print is output To do this the parameter FFONEND hast to be added The default value for this parameter is NO Enter FFONEND YES if the form feed is to be sent Example XCPRT NAME SALIAS PRT LPD1 PRINT 20 FFONE In some LPDs on PCs the names of the windows printers are assigned to a TCP IP printer name Use this name in the PRT parameter Example The name of the Windows printer is Laser Jet The LPD sends the print
155. obcomUserld has to correspond with the entry PW in the HOBCOM As RACF Userid then the HOBCOM entry USERID will be sent to RACF as RACF password the hlk entry Passwords If two different HOBCOM communicate with each other the personal entry has to be entered in the TCT of the HOBCOM that manages the real terminals resp on which the emulation logs on 7 4 LOGMODE For the LOGON of HOBLink 3270 a special logmode CODLOG 1 1 is required This logmode is con tained in the MODTABCX on the installation tape Please add this logmode in your current modetab or reload the new modetab and enter your name to gether with the name of the logmode at any LU definition that HOBLink 3270 uses Example MODETAB MODTABHS DLOGMOD CODLOGI1 7 5 USSTAB If the LOGON is not performed when starting the USSTAB command COD91Y can be used This com mand is contained in the USSTABHS on the installation tape This command uses the logmode CODLOG11 i e the MODTABHS has to be loaded before and the HOBLink LUs get the entry USSTAB USSTABHS MODETAB MODTABHS Entry from USSTABHS COD91Y USSCMD CMD COD91Y REP LOGON FORMAT PL1 USSPARM PARM APPLID DEFAULT HOBCOM DEFINING PCS WITH 3270 Y PROTOCOL USSPARM PARM LOGMODE o EFAULT CODLOG11 Entry from MODTABHS CODLOG11 MODEENT LOGMODE CODLOG11 FMPROF X 03 TSPROF X 03 HOBCO
156. oftware Support HOB under MVS OS 390 DEFINING PCS WITH HOBLINK 3270 Y PROTOCOL 7 DEFINING PCS WITH HOBLINK 3270 Y PROTOCOL 7 1 GENERAL REMARKS CONCERNING THE INSTALLATION The communication between HOBLink 3270 version 2 1 or higher and HOBCOM is performed with a HOB owned protocol the so called Y protocol This protocol makes it possible to encrypt and compress the data stream In order to allow PCs that have HOBLink 3270 installed to communicate with HOB COM the following definitions are required on the host 7 2 PASSWORD IN THE HOBCOM TCT In the HOMCOM TCT you have to enter a password which contains information about the number of Y sessions that are to communicate with HOBCOM This password you can obtain from the HOB support If two different HOBCOM communicate with each other the password has to be entered in the TCT of the HOBCOM that manages the real terminals resp on which the emulation logs on 7 3 PERSONAL ENTRY IN THE HOBCOM TCT In the HOBCOM TCT one personal entry is required at least This entry contains the encryption key You can choose freely a different encryption key for every user The encryption key can have a length up to 32 byte The default value that HOBLink 3270 uses is GUEST That means that normally one person GUEST has to be entered in the HOBCOM The personal entry GUEST is not necessary if no PC uses the default value i e if any HOBCOM
157. on 1 or 3 is installed the terminal is running in the REMO TE status and the terminal is switched off normal case HOBCOM sends the message 00050 D LOG ERR RTNCD 10 FDBK2 01 SENCE 080A0000 And as a result a terminal connected to an SNA control unit if it determines after having been switched on that no session has been established sends the command CODIS The instruction CODIS is converted to a logon in the VTAM application HOBCOM with the help of the USSTABSA Under VTAM Version 2 the terminal logon in HOBCOM occurs after the terminal is switched on If VTAM Version 2 is installed use the USSTABS1 or USSTABS2 table The table with delayed switch off should be preferred when using remote terminals since VTAM also sends messages specified in the USSTAB after line error etc before the terminal is logged on in HOBCOM The following tables can be found in the appendix 055 1 USSTAB for NON SNA control units the terminal is switched off immediately USSTABN2 USSTAB for NON SNA control units the terminal is switched off with delay 055 51 USSTAB for SNA control units the terminal is switched off immediately USSTABS2 USSTAB for SNA control units the terminal is switched off with delay USSTABSA USSTAB for SNA control units and VTAM version 1 the terminal is switched off with delay 2o HOB HOBCOM under MVS OS 390 DEFINING TERMINALS AND PRINTERS 3 3 DEFINING A LAPTOP PC WITH HO
158. onding program nameafter LOAD WRONG TEXT AFTER USSTAB COMMAND Text has been entered after the command abbreviation Enter only the command abbreviation INCORRECT USSTAB GENERATION An incorrect command has been generated for USSTAB generation Ask your system program mer for assistance PROGRAM PARTITION NOT AVAILABLE A connection to another HOBCOM has been established using REVM In the process the virtual terminal number Pn in the command line has been written over this is invalid because REVM makes only one virtual terminal available HOB MESSAGES HOBCOM under MVS and OS 390 11 3 HOBCOM CONSOLE MESSAGES UNDER MVS XCM XCT HOBCOM Main Task Messages 00001 START HOBCOM 1 2 D The HOBCOM program version 1 2 has been started XCM00002 SUBPOOL SIZE FOR THIS START UP IS HOBCOM has been allocated xxx K main storage space which will be managed dynamically This message appears only in the DOS version of HOBCOM in the MVS version the necessary storage space is provided by the operating system XCM00003 ENOUTH MAIN STORAGE HOBCOM has not been allocated enough main memory space HOBCOM is terminated imme diately This message is used only in the DOS version of HOBCOM and does not appear in the MVS version of HOBCOM 00004 NO STORAGE AVAILABLE ABEND is terminated because no more storage space is available This situation should not occur since HOBC
159. or each group a basic mask and a set of command abbreviations can be defined In addition authoriza tion for HOBCOM operator commands can be extended on a group basis If no such entries are made HOBCOM uses the standard definitions XCUSSOUT and XCUSSCOM An example for a group entry with own group labels is in the appendix HOB io TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and OS 390 TIMEOUT n MASKP n P1COM P2COM P3COM P4COM Example n is a number between 1 sec and 2 billion sec Hex value in one full word When this parameter is used the sessions will be closed by HOBCOM after n seconds when the connection is broken by the end device HOBLink J Term or HOBLink 3270 i e not normally close with the LOGOFF command The value 0 is the default value that means no timeout n 8 for P1 4 for P2 2 for P3 1 for P1 n is a flag Bit for a mask The Bits can be combined as you like The default value for n is 15 This mask controls which P keys are allowed If MASKP 8 is entered only P1 is allowed Changing to P2 P3 and P4 is not possible then These parameters specify which commands or command abbreviations are performed automatically when this P key is pressed This makes it possible to suppress that the HOBCOM basic mask appears on this P key When the user logs on the desired application appears immediately You can en ter a valid command abbreviation the group was assigned to an USSCO
160. ple the action by the in terlaced subentry you specify the single compares Format Length of Sub Entry Length of values to compare c the macro XCSCRMC With it the compare criterias are defined on this basis the actions should happen which are programmed in the subentry You can create several XCSCRMC inside of a subentry All COMPARE 5 have to be succesful that the programmed actions can follow AND condition of all XCSCRMC HOB 75 TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and OS 390 XCSCRMC POS Hl CHARVAL By POS you specify the position inside of a screen on which the compare should happen For example the characters which are queried are situated in line1 column 1 Then you state the position as X 0000 With HEXVAL or CHARVAL you can specify the wantes characters By CHARVAL single quotes aren t possible Blanks aren t allowed in the string who has to be compared The strings with that are compared stand at the Displacement 0000 to 3FFF The attributes with that are compared stand at the Displacement 4000 to 7FFF and the SMD BLOK begins at the Displacement 8000 A certain field in the SMD BLOK can be defined as position e g the special register SMD SPRE This register can be queried on a specials contents with HEXVAL or CHARVAL This register is set by calling from COVTC It can be filled for example with 1 by the first action and in the second subentry the register can b
161. quest for RACF UserID Disp 1 Length 2 position in the screen of UserID request for RACF pass ticket Disp 1 Length 2 position in the screen of UserID contents is 1 X FFFF if not set Disp 3 1 Position in the screen for passticket Disp 5 t Length of application names Disp 6 1 t application name HOB 7 TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and OS 390 6 16 6 Keycodes for the actions For the keycodes actions are needed The following keycodes are possible Code 0104 0115 0116 022A 022B 0240 Meaning Enter Clear Delete 1 2 01 02 PF03 PF24 The keycodes are programmed like the commands as DC statements in the order they should be execu ted 6 16 7 Example 1 Loggon in TSO without RACF KEK KK KK KKK KKK KKK KKK KKK KKK XCSCRMA DS OF KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK SCREEN MASK TABLE BEGINNING E SCRE EN1 ELABEL SCRIE Header 1 ELABEL S SCRIE first subentry ELABEL S ERSON 55 POS SMD TE POS SMD 78 SCR1 interlaced subentry SPERS SMDSBLOK X 8000 HEXVAL 00000055 2 SSPRE SMDSBLOK X 8000 HEXVAL 0000 HOB HOBCOM under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM XCSCRMC POS X 0001 CHARVA
162. r a batch task This para meter cannot be executed Program Error Messages ERROR FUNCTION NOT DEFINED You have entered a function number which is not defined in the menu ERROR ENTER PROGRAM NUMBER 1 TILL 4 A terminal number between 1 and 4 corresponding to P1 to P4 must be entered ERROR NO SCREEN THAT CAN BE STORED The screen content of the corresponding virtual terminal cannot be saved or printed ERROR ENTER ADDRESS 1 TILL 8 IN STORE A memory location number between 1 and 8 must be entered because you have saved more than one screen ERROR THERE IS NO SCREEN IN STORE No screen has been stored ERROR ONLY ONE SCREEN IN STORE Only one screen has been stored ERROR BACKGROUND PRINT IS ACTIV Your print output can not follow immediately because a background print is activ ERROR TERMINAL NAME IS INVALID The first character of the printer name may have been entered as a space The first character may not be a space ERROR TERMINAL NAME IS NOT GENERATED You gave the name of a not generated terminal as a printer name 132 HOB under 5 OS 390 MESSAGES 11 7 PR3287 MESSAGES ERROR 10000001 COMMAND IS INVALID The command entered is either incomplete or incorrect ERROR PR010001 PROGRAM IS BATCH P The selected program can only be invoked from the HOBCOM console ERROR PR010002 EITHER OUTFILE OR PRINTER NAME You may use only one of the two parameters for invoking ERRO
163. r notify the HOB Customer Service ERROR 0007 PAPPL xxxxxxxx NOT DEFINED x The primary application entered e g CICS TSO IMS has not been defined ERROR 0008 PAPPL xxxxxxxx NOT ACTIVE x The required primary application application program e g CICS TSO IMS is not active and therefore cannot be selected ERROR COVT0009 LOGMODE NOT DEFINED The LOGMODE entered is not defined in your MODTAB Ask the system programmer for a valid LOGMODE ERROR COVT0010 LOGON REJECTED RC xx SENSE xxxxxxxx A logon to the primary application has been rejected The RC and SENSE values indicate the cause Consult your VTAM Manual VTAM Messages the Chapter on Return Codes Sense Fields and Return Code Posting Return Code Combination HOB 129 MESSAGES HOBCOM under MVS and OS 390 ERROR COVT0011 NO BIND OUT OF SERVICE The selected application does not send a Bind no connection is established This may be be cause the virtual terminal SAPPL has been set OUT OF SERVICE ERROR COVT0012 NO SDT NON SNA INSTALLATION The requested application does not send a SDT command SDT set data traffic The BIND pa rameters registers that the connection has already been made A possible cause is that the vir tual screen SAPPL has been incorrectly installed in the application program e g in CICS for example as non SNA terminal ERROR 0013 NO UNBIND TIME LIMIT The session with the requested VTAM applica
164. rameter What each of the tables does is described in the following chapters A standard TCT is supplied which may be modified if required On the installation tape it is located in the source library HOBCOM LIB1 The XCTCT should be modified to meet your requirements assembled and cataloged in the HOBCOM library A DD statement for the MACLIB must be inserted in the Job for the compilation of the XCTCT For ex ample SYSLIB DD DSN HOBCOM MACLIB DISP SHR The name of the table is read when is started For example if the table is called XCTCT the following card will be read PHASE The card is read from the file allocated to the label PARAM No message is output if no valid input was read or if the table could not be loaded As soon as the table has been successfully loaded HOBCOM acknowledges it with the following mes sage 00005 PHASE XCTCT LOADED Dynamic re loading is possible For more information refer to the HOBCOM Operator Guidelines In the appendix of this manual and on your installation tape in the HOBCOM LIB1 you will find a sample job for starting HOBCOM 6 2 THE NAME FOR The default value for the ACB name is CODIS If your ACB access method control block in VTAM is to be given a name other than CODIS it can be entered in ACBNAME The name may be up to eight cha racters in length This ACB will be opened when is started Whe
165. rd etc A print parameter can also be created using the macros XPRPDEF or XCFOR Macro XPRPDEF E name SPACING nn LPP nn LABEND label NAME enter the name of the print parameter here The name be up to 8 characters in length SPACING the number of characters per inch is to be entered here The default value is 12 LPP enter the number of lines per page here This value is not passed to the printer but rat her serves as a HOBCOM internal counter The default value is 72 FEATURE if you specify FEATURE HEX here the two characters following X 5F are interpretted as hexadecimal values This entry is useful when you want to send control characters to the printer LABEND a label can be entered here as long as entries for the current print parameters follow the Macro XPRPDEF These entries must be made as DC define constant statements If you wish to make additional entries use the macro XCFOR A print parameter can be entered using the macro XCFOR if it consists of only one print statement Otherwise the individual strings must be defined using DC define constant statements see the examples at the end of this chapter Macro XCFOR XCFOR ABB name PAR print record s4 HOB HOBCOM under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM name enter the name of the print parameter here the name may be up to eight characters in length print record enter the character
166. s LU 8 1 2 Printing on a 3270 printer connected to a CUT Terminal Printing other than the local hard copy from a CUT terminal is only possible when a printer session is allowed by the terminal software Such terminals are e g the HOB 470 Series terminals and the IBM Info Window terminals For any other terminals please check the set up to see if a printer session is allowed The printer address of a CUT terminal must be the second entry in the control unit The other definitions and the printer invocation are analog to those given in chapter 7 2 1 8 1 3 Printing Using Form Parameters When printing from CICS form parameters can also be used which are passed by program PR3287 When printing from a standard 3270 terminal some restrictions must be observed 1 It must be possible to enter a bypass character in the terminal set up or the terminal software must recognize a bypass character 2 In the printer parameter no FF lines may appear in the printer parameter If parameters are to be passed which normally appear in a line then this line should be converted to a 90 line See the following example The following example shows a form parameter which allows landscape format PPFOR11 1 PARAMETER FOR HOB 8LP AL2 PPFOR11Z PPFOR11 LENGTH FORM CL8 X3 NAME FORM A L1 L PPFOR11A LENGTH PPFOR11A X 905FF1C25093F1D7 PPFOR112 The meanings of the codes in the 90 li
167. s case from the macro XCPRTSMB parameter PW Userid is the entry by the parameter HCNAMED in the macro XCSMBDD from the WINS server If a userid and a password are given in the macro XCSMBDD they will be ignored 2 Microsoft Networks 3 0 3 LANMAN 1 0 4 LM1 2X002 The parameter PROT is optional The default value is 4 Actually the smallest common value both interlocutors are able is used for the communi cation YES or NO NO is default YES is given if it is the last entry in the table XCTERMA Das Makro XCSMBDD The following parameters are possible 110 HOB HOBCOM under MVS OS 390 HOBCOM AND TCP IP NAME HOBCOM internal name of the domain description In the table XCSMBDOM are several of this entries possible Which of that entries the respectivve printer defined through XCTPRSMB uses is defined through the parameter SMBDOM in the macro XCTPRSMB DOMAIN this parameter declares the name of the Windows domain HCNAMED You can choose this name HOBCOM identifies oneself together with the parameter DOMAIN in the Windows domain IPADDRP The IP address of the WINS server is declared which is called from HOBCOM IPADDRS this parameter is optional Here you declare the IP adress of a substitute WINS server if the first is not available at the moment USERID this parameter is optional It is necessary if a user authorization and a password from PDC is expected from HOB COM to print on the printer
168. se entries become meaningful when a program is available that sends a file from the disk to the printer SPFIL3 specifies the name under which the file will be stored in the archives in the above example TSP plus a sequentuial number The output on disk results in EDLI format i e the file will be stored in the cabinet SPOOL in the archi ves The binder name results out of the second part file name of the driver HOB DRIVER ROUTINES HOBCOM under MVS and OS 390 10 2 PUN The driver routine PUN can send data into the punch system There is no translation into ASCII format 1 part filename fix SPUN The second part filename defines the output format PUN punch format makes unchanged output of the record contents possible when the lines are not longer then 80 digits PRINT print format causes the HOB feedbyte to be split into two characters aufgeteilt wird und records that do not fit onto a hole card column 3 to 71 to be set up The third part filename will be entered in the XCTCT as a name out of the XCUCLTAB that is responsible for the necessary job control 10 3 PRINT The driver routine PRINT makes print output on a system printer possible It transferres i e a HOBTEXT text into IBM format and makes output possible on printers that tolerate no HOBTEXT format There is especially no transfer into ASCII format 1 part filename fix SPRINT 2 part filename name entered in
169. splacement 2 shows the beginning of your program Register 1 points on the parameters Displacement 0 00 Enter FF Exit Displacement 1 20 print program 40 remote program 80 VTAM program REVM AND COAPPCVT use 40 COVTC AND COVTOP use 80 PR3770 AND PR3287 use 0 80 20 Displacement 4 address TS USER in TS BLOCK of the running task in a full word Displacement 8 at entering entered SAPPL length 8 at exit delivered SAPPL Displacement 16 output generated by the system due to the terminal name SAPPL length 8 only at entering Displacement 24 output target given by the user PAPPL Register 13 points to the HOBCOM SA BLOCK This owns a save area in the first 72 bytes in which you can save the registers The programm will be stored SA UPNAM the program lenght stands in the first half word SA UPNAT may be used freely i e to enter the address of an ordered storage These two HOBCOM system blockshare described in the macro XCTDEF Register 14 contains the address for jump back 70 HOBCOM under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM Register 0 and register 2 to register 12 are unpredictable and therefore their contents cannot be used But they must be secured so that they are available to HOBCOM for backjumping In register 15 the return code from your program is transferred at backjumping is it unequal zero the register points to your own error message that is then put
170. t have wide effects User entries screen displays of HOBCOM and Listings are printed in this type face and are marked with a frame Numerous HOBCOM commands can be abbreviated In this case the smallest possible entry is marked with bold face Example CO DISPLAY TASKS Smallest Entry CO D TAS Parts of the command syntax which are not variable are written in uppercase Parts of the commands which can be selected by the users or which depend on the configuration of the host system are written in lowercase Function keys are designated as F1 F2 etc Some keyboards are labeled with PF1 PF2 etc under MVS OS 390 GENERAL REMARKS HOB INSTALLATION GUIDE HOBCOM under MVS and OS 390 2 INSTALLATION GUIDE 2 1 STEPS FOR A FIRST INSTALLATION Storage Requirements Since the available virtual main storage is managed dynamically HOBCOM checks at startup how much memory is available Decisive is the value in the REGION parameter in the appropriate job resp in the approproate EXEC statement Because of the dynamic management of the virtual storage no precise specifications of the storage requirements can be made The amount of main storage required increases with the number of terminals turned on and the number of virtual screens operating How much storage you will actually need can best be estimated based on practical experience with the system for this the HOBCOM operator co
171. t specifiing a resource ID for his PC a name e g 0109 is assigned HOBCOM saves the generated name and starts the task If the PRVM program will be started by this user the name 0109 will be entered for the PRl parameter as if the following EXEC command would be entered EXEC PR3287 SA sapplname PRI TN 0109 If a user sends to HOBCOM data with the class A this data will be output on the PC TN 0109 When is set the task name will be used as printer name In the example above the task would be started but HOBCOM would try to output the print on a device with the name HUGO The print will be sent to the PC that specified as resource ID HUGO If no terminal exists that has this name PR3287 will not be started Another Example XCUBT TASK HUGO PERSNO 00000055 BTPRI NO PR3287 SA sapplname PRI TN 0001 The task will be started if the person Miller logs on The output will be performed on the PC that logged on first without device or resource ID since HOBCOM was started 9 7 PRINTING OVER SMB It is possible to print the SMB Server Message Block protocol on a PC with HOBCOM The 3270 emu lation has not to be installed at the PC SMB is a protocol which is used in Microsoft networks The support for SMB over Netbios and over TCP IP is contained in Windows and OS 2 HOBCOM supports by printing over SMB TCP and UDP on IP corresponding the recom
172. t you may not change the messages in this USSTAB Pease note that you may not change the mesages in this USSTAB Further information on laptops can be found in chapters 5 3 and 5 12 and in the appendix 26 HOB HOBCOM under MVS OS 390 DEFINING TERMINALS AND PRINTERS 3 4 COMMUNICATION OVER TCP IP DEFINITION OF A TN3270 SESSION The connection to HOBCOM from PCs can be made over TCP IP with a TN3270 application Requirements for doing this TCP IP for MVS on the host TN3270 capable application on the PC TCP IP on the For the communicatoon in the TN3270 application the IP address of the host has to be entered 0 194 45 234 100 Additionally the correct port number has to be entered For HOBCOM e g PORT 1026 To make a port known an OPEN command has to be entered e g in HOBCOM OPEN TCPIP TELNET PORT 1026 Ports that are already used by other programs e g port 23 may not be used The port entry has to cor respond with the entry made in the emulation When you make this OPEN TCPIP already has to be started and active After you close and restart TCP IP it is not sufficient to make a second OPEN in HOBCOM A CLOSE has to be made before In HOBCOM CLOSE TCPIP TELNET PORT 1026 If the job name of the TCPIP on the host is TCPIP no additional entry in the TCT is necessary If you use a different job name this name has to be made known for HOBCOM in the HOB
173. ter types for E terminals in the following chapter The macros XCTLTM and XCTLTS are used for entering laptops ERMA DS OF XCTLTM TERM X25T01L XCTLTM TERM X25T02L XCTLTM TERM X25T03L XCTLTS TERM LAPTOPO1 PRINT 99 XCTLTS TERM LAPTOP02 LTKEYP AB PRINT 09 XCTLTS TERM LAPTOP03 PRINT 06 XCTLTM master entries for laptops LU Eintrage in switched major node XCTLTS slave entries for laptops PSEUDO LU name in PAD Setup If someone should receive a personal laptop password here you have the possibility to give the parame ter LTKEYP This parameter inverts the third byte and replaces the fourth byte of LTKEY Examples 1 Neither the parameter LTKEY nor the parameter LTKEYP is set In this case the host password 00000000 must be entered in the laptop 2 The parameter LTKEY is set the parameter LTKEYP is not Now the character chain that has been given as LTKEY has to be entered as host password 3 The parameter LTKEY is not set but the parameter LTKEYP is In this case the host password in the laptop must be set together as follows 1st and 2nd byte 00 each 3rd Byte FF 00 inverted 4th Byte LTKEYP 4 Both parameters are set The host password in the laptop PC is set together as follows 1st and 2nd byte 1st and 2nd byte of LTKEY 3rd Byte 3rd byte inverted from LTKEY 4th Byte LTKEYP Example see above HOB i6 TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS a
174. the XCJCL4 macro for NAME in the XCTCT 3 part filename name of the print output in the power list queue Example In the XCJCLTAB exists a JCL entry with name TEST UP Then the driver routine is called as follows PRINT TEST UP TEST whereas TEST is the name of the printout in the power list You will find information about the pertaining entries in the XCJCLTAB of the TCT 10 4 SCREEN The contents of a virtual terminal of the real terminal on which one is just working on can be read with help of the driver routine SSCREEN 1 part filename fix SCREEN The second Part filename determines the number of the virtual terminal from which will be read Pn instead of n enter the number of the virtual terminal 1 2 3 or 4 xxxxxx the third part filename is not being evaluated at the moment This driver routine is used by HOBTEXT to read the contents of a second virtual terminal Example invo ke HOBCOM under MVS OS 390 HOBCOM DRIVER ROUTINES SCREEN P3 xxxxxx 10 5 8TCT The driver routine TCT reads entries of the printer parameter from the VCTCT 1 part filename fix TCT 2 part filename fix PARAM Enter as third part filename the name of the chosen parameter from the VCTCT table XCPRPAR Example invoke TCT PARAM FSP10H 10 6 DIALOG The driver routine DIALOG opens a virtual terminal which makes communication reading and writing with any optional sub system possible
175. the chapter on Return Codes Sense Fields and Return Code Posting Return Code Combination XCTM0051 ID xxxxxxxx LOSTERM RC xx HEXA A terminal has been logged off refer to VTAM Manual VTAM Programming in particular the chapter on Using Exit Routines Lost Term The connection to the real terminal xxxxxxxx has been severed due either to the operator command V NET TERM ID or a data transmission line faillure 52 ID xxxxxxxx REC ERR RTNCD xx FDBK2 xx SENSEZXXxxxxxx HOBCOM has received an error message from terminal xxxxxxxx A receive error has been regi stered For more information refer to the VTAM manual VTAM Messages in particular the chap ter on Return Codes Sense Fields and Return Code Posting Return Code Combination HOB 123 MESSAGES HOBCOM under MVS and OS 390 XCTEOO053 ID xxxxxxxx SEND ERR RTNCD xx FDBK2 xx SENSE Xxxxxxxx HOBCOM has received an error message while sending a record to terminal xxxxxxxx Refer to the VTAM manual VTAM Messages in praticular the chapter on Return Codes Sense Fields and Return Code 54 ID xxxxxxxx SEND ERROR POWER OFF HOBCOM has determined while sending a record to terminal xxxxxxxx that the terminal is turned off The terminal was not switched off properly using LOGOFF 55 ID xxxxxxxx ERR RTNCD xx FDBK2 xx An error was indicated while executing the VTAM request R XX Refer to the VTAM manual
176. the virtual printer is not entered in the appropriate table POWER JES ERROR 020026 NO SDT NON SNA INSTALLATION The selected application does not send an SDT command SDT start data traffic although BIND registers that the connection has already been established N B the application must al ways be entered as an SNA application regardless if the real terminal is an SNA terminal or not Check your applications ERROR 20027 NO UNBIND TIME LIMIT The session with the selected VTAM application has been terminated but the VTAM application has not sent an UNBIND for this reason the session is terminated by PR3770 A possible cau se is that the VTAM application was terminated abnormally ERROR 020028 REQ xxH RTN xxH FTN xxH An error has been reported to program PR3770 The request code for the current access is xx Refer to the VTAM Manual VTAM Messages Chapter Return Code Sense Fields and Return Code Posting Return Code Combination to find the cause of the error or inform the HOB Cu stomer Service ERROR PR020029 SAPPL xxxxxxxx CLOSE ERROR xxH An error was reported to program PR3770 while closing the VTAM ACB Consult the VTAM Maunal VTAM Messages Chapter Return Code Sense Fields and Return Code Posting Re turn Code Combination to find the cause of the error or inform the HOB Customer Service ERROR PR020030 15 The VTAM access xxxxxxxx e g GENCB was incorrectly terminate
177. tion has been terminated but the VTAM application has not sent an UNBIND for this reason the session is terminated by COVT This be be cause the VTAM application has been terminated abnormally ERROR COVT0014 REQ xxH RTN xxH FTN xxH An error has been reported to the program COVT COVTC or COVTOP The request code for the current access is xx Refer to the VTAM Manual to find the cause of the error or inform HOB Cu stomer Service ERROR COVT0015 SAPPL CLOSE ERROR xxH An error was reported to program COVT while closing the VTAM ACB Refer to the VTAM Manu al VTAM Programming chapter Description of the VTAM Macro Instructions to find the cause of the error or inform the HOB Customer Service ERROR COVTOO16 R15 xxH ROO xxH The VTAM access xxxxxxxx e g GENCB has been incorrectly terminated with the return code xx Refer to the VTAM Manual VTAM Messages chapter Return Codes Sense Fields and Return Code Posting Return Code Combination to find the cause of the error or inform the HOB Customer Service 130 under 5 OS 390 MESSAGES 11 6 NOTE MESSAGES Error Messages When Invoking Note ERROR 10000001 COMMAND IS INVALID The command entered was either incomplete or incorrect ERROR NOTE0002 OUTFILE AND PRINTER ENTERED You may use only one of the two parameters for calling ERROR NOTE0003 OUTFILE AND SFN3 ENTERED You may use only one of the
178. tween the end marking of a existing table and the beginning of the next table XCSCRMA DS OF DC 12 0 end marking d Between you can query individual screen contents with the following macros and programming corre sponding input XCSCRMH Header XCSCRMS Sub Entry XCSCRNC Compare 74 HOB HOBCOM under MVS OS 390 TERMINAL CONTROL TABLE FOR HOBCOM The announcement on the first application happens with the parameter SCRMA by the program COVTC COVTC PA CICS SA SCRMA headername 6 16 2 The macros XCSCRMH XCSCRMS XCSCRMC a the macros XCSCRMH With it a screen mask is programmed This contains a name and it has to be specified at the end of the table XCSCRMA with ELABEL End Label The table XCSCRMA can contain several Screen Masks XCSCRMH NAME ELABEL Format Length 2 Length over the whole Screen Mask 1 Length 8 Name of the Screen Mask Entry Length 1 Typ of Entry 00 b the macro XCSCRMS With it a subentry is determined You can define several subentries inside of a header If the parameter ELABEL is specified you can determine the respective end XCSCRMS ELABEL Comparing operations are defined with the help of XCSCRMC inside of a subentry If they are fulfilled the operations are executed that were programmed inside of this subentry The subentries can be interlaced By the first subentry you specify for exam
179. ubentry XCSCRMS ELABEL S2CR2 interlaced subentry ECIAL REGISTE XCSCRMC POS SMDSSPRE SMDSBLOK X 8000 HEXVAL 0001 XCSCRMC POS X 0234 HEXVAL D781A2A2A6969984 EQU DC X 21 FETCH RACF PASSTICKE DC X FFFF USERID 1 DC AL2 8 1 80 20 1 CURSORADRESS OF PASSWORD DC 11 7 LENGTH APPLIKATION DC 50 390 E OF APP FROM CLASS DATA 0101 ENTER X 110002 SET SP End Header 2 DC AL2 0 END OF TABLE KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK 6 17 HOBCOM PASSWORD XCPASSW The macro call happens at the end of the TCT after entering the XCOMASK label ck Ck KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK Ck ck Ck kk ck Ck Sk Ck Ck ck Sk Sk Ck Sk Sk Sk kv XCPASSW DC X nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn The delivered 34 character password is to entered at this point 17 Bytes This password checks among other things the ACB name of HOBCOM and makes additional options possible like STTE It is limited in time and is yearly renewed If you shouldn t receive a new password before expiration of the time limit please inform the HOB S
180. ue This parameter is not required if the default value is used TN3270 This parameter specifies if the printer is connected to HOBCOM over TN3270E or SNA PRINT This parameter always should be specified Enter the driver reference number of the printer If you use a TN3270E printer S protocol only 100 can be used For SNA all drivers can be used If TYPE TN3270 the driver 100 will be used by default if this pa rameter is not entered ATTENTION If you enter TYPE TN3270 and not the value 100 PRINT HOBCOM can crash If the parameter is not entered the first driver of the TCT that has a three digit reference code is used LOGM This parameter is only effective if TYPE SNA is used This entry overwrites the logmode that was entered in VTAM for the printer LU Possible values SCS DSC2K DSC4K etc If the parameter is entered when TYPE TN3270 is used it will be ignored LUTYPE 1 This parameter is only effective if TYPE TN3270 is used 3 This entry determines if the data is sent to the printer as SCS data LUTYPE 1 or as DSC data LUTYPE 3 The default value is LUTYPE 3 If the parameter is entered when TYPE SNA is used it will be ignored DISCON NO NO is the default value YES LASTTE NO NO is the default value YES This parameter has to be entered in the definition of the last terminal printer in in the VCTCT The Driver 100 Under VM the driver 100 can be used only for TN3270E printers If the TN3270E printer
181. ur o bagi RR en Rea 11 6 NOTE MESSAGES itii iet eph HERBERT IIR 11 7 PR3287 MESSAGES etre es elena e ese idee Lus eua snl te metae 11 8 83770 MESSAGE Si iter tree rae eed eu suy t 11 9 MESSAGES OF THE XCTCPIP2 A APPENDIX A SAMPLE JOBS file A 2 Sample for Terminal CHANGING THE PRINTER A 4 EXAMPLE FOR AN EXIT ROUTINE A 5 ERROR MESSAGES WHEN USING 0 A 6 HOBCOM OPERATOR COMMANDS 113 113 114 114 114 115 115 115 116 117 117 118 120 127 129 131 133 137 141 HOBCOM under MVS and OS 390 7 HOBCOM PROGRAM PARAMETERS 162 8 HOBCOM PRINT PROGRAM 163 9 te aa sek bete tem decr deae n e ae xeu Ped 164 A10 2 165 A 11 STANDARD ASSIGNMENT OF HOBCOM DRIVER ROUTINES 171 A 11 THE HOBCOM CHARACTER 172 INDEX 174 under MVS OS 390 GENERAL REMARKS 7 GENERAL REMARKS HOBCOM under MVS and OS 390 1 GE
182. ure that explanations of the abbreviations also appear on mask 2 DC END OF TABLE XCCOMASK DS OF HOBCOM OPERATOR MASK APPENDIX HOBCOM under MVS and OS 390 XCOP COMM CONSOLE ALL ALLOWED XCOP DIS YES SHU NO COMMANDS F TERMINAL CAN NO DISPLAY IS ALLOWED ALL OTHER DISC NO TCTLOAD NO COMMANDS NOT XCPASSW DC X nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn LTORG END XCTCTANF A 3 CHANGING THE PRINTER DRIVERS The extension of the EPSON standards has made a further differentiation of our EPSON drivers 09 and 12 necessary Whether or not you need a different printer driver can be recognized by checking the line spacing If it is wrong you need a new driver If the only problem you encounter is printing the German umlauts you can simply change the character set on the printer Generally speaking driver 9 does not support graphic characters and normally makes use of the the italic character set driver 12 supports the HOBTEXT graphic characters and normally requires the extended EPSON character set If the bit is not set 1 180th of an inch is used for the vertical feed If itis set 1 216th of an inch is used for the vertical feed Required changes in the HOBCOM TCT Example Bit is set Bit is not set for 1 180 for 1 216 PPRINTO9 EQU PPRINT49 EQU DC 0009 X 0049 DC DC DC 00 DC DC 0 009
183. virtual terminals and printers in HOBCOM However to simplify the assignment of terminal names try to adhere to the following guidelines Each terminal is assigned a name with a maximum of seven characters For each of the four virtual screens P1 to P4 an additional digit from 1 and 4 is appended to the name The name of the printer can be had by adding a p to the terminal name If the termnal already has 8 character name the first character is to be deleted before appending 1 to 4 or p to the name HOB 2o DEFINING TERMINALS AND PRINTERS HOBCOM under MVS and OS 390 Since names are not allowed to begin with numbers the first digit can be replaced by a sign Examples The name of the real terminal is NO1 The virtual screens are to be assigned the names 011 012 013 014 The virtual printer will be assigned the name NO1P The application HOBCOM controls all real screens therefore you should specify a value for EAS EAS n maximal number of screens operating under HOBCOM Choose a value which is 20 higher For instance if you want to have 10 screens enter 12 The virtual screens operate with only one application therefore specify EAS 1 for each virtual screen The virtual printer can go into session with many applications therefore you can enter EAS n When defining virtual screens you should specify a DLOGMOD parameter Application programs which interrogate the BIND paramter can then determine w
184. word an additional HOBCOM feature The password offering the required number of sessions can be bought over the HOB support 28 HOBCOM under MVS OS 390 DEFINING TERMINALS AND PRINTERS 3 5 DEFINING THE MAJORNODE HOBCOM THE APPLICATION HOBCOM AND THE VIRTUAL TERMINALS AND PRINTERS IN VTAM For the application program HOBCOM as well as for each virtual screen of a HOB E terminal and a virtual printer applications are defined Example HOBCOML1 VBUILD TYPE APPL HOBCOM APPL ACBNAME HOBCOM AUTH ACQ PASS EAS 30 011 AUTH NOPASS EAS 1 DLOGMOD D4C32782 12 UTH ACQ NOPASS EAS 1 LOGMOD D4C32782 013 UTH ACQ NOPASS EAS 1 LOGMOD D4C32782 014 UTH ACQ NOPASS EAS 1 LOGMOD D4C32782 ACBNAME N01P AUTH ACQ NOPASS VPACING 1 EAS 2 The name of a major node in the above example HOBCOML1 cannot have the same name as the appli cations The MAXAPPL parameter in VTAM must be large enough to accomodate all of the applications Each virtual screen and each printer is considered to be an application Therfore one real terminal together with a printer will have 5 applications four virtual screens and one printer The name of the major node which has been defined for must also be listed in VTAM Convention You can use any name you like for
185. x LOGON PA CICS 01 1 x A NO X A NO SHUTDOWN The 3287 program invoke and logging onto CICS happen automatically when the terminal is turned on and the SHUTDOWN command becomes effective when the terminal is turned off HOB TERMINAL CONTROL TABLE FOR HOBCOM HOBCOM under MVS and OS 390 6 10 PERSONAL ENTRIES XCPERSTA These entries are only nessessary when HOBTEXT HOBLIST or STTE is used ERS NO TYPE NAME PW NO number TYPE type NAME name PW passwort ENKEY key ENFULL value GROUP groupno PROFDl mainfolder name PROFD2 ordnername PROFD5 textname MATLID1 mainfoldername MAILID2 foldername MATLOD1 mainfoldername MAILOD2 foldername COMASK commands the personnel number of the user you wish to enter This can beany 8 digit number of your choice the type of user entry is indicated here Person and group entries are possible P person g group enter the name of the user here the entry may be up to 16 characters long the user s password must be entered here The password may be up to 8 alphanumeric characters in length getragen werden The following entries have a meaning only for HOBTEXT and HOBLIST GROUP PROFD1 PROFD2 PROFD3 the name of the group to which the user belongs can be entered here The group name may be up to 8 characters in length specifies the cabinet

HOBCOM

Contents

Download Pdf Manuals

Related Search

Related Contents