AOP_SAP2AFP_RESOURCESuserinit

z/OSInfoprintServerMigrationG544-5743-03z/OSInfoprintServerMigrationG544-5743-03NoteBeforeusingthisinformationandtheproductitsupports,besuretoreadthegeneralinformationin"Notices"onpage181.
FourthEdition(April2002)ThiseditionisamajorrevisionofG544-5743-02.
Itappliestoz/OSVersion1Release2,ProgramNumber5694-A01;toz/OS.
eVersion1Release3,ProgramNumber5655–G52;toInfoprintServerTransformsVersion1Release1ModificationLevel1,ProgramNumber5697-F51;andtoallsubsequentreleasesandmodificationsuntilotherwiseindicatedinneweditionsortechnicalnewsletters.
Besuretousethecorrecteditionfortheleveloftheproduct.
OrderpublicationsthroughyourIBMrepresentativeortheIBMbranchofficeservingyourlocality.
Publicationsarenotstockedattheaddressgivenbelow.
TheIBMPrintingSystemsDivisionwelcomesyourcomments.
Aformforreader'scommentsisprovidedatthebackofthispublication.
Iftheformhasbeenremoved,youmaysendyourcommentstothefollowingaddress:INFORMATIONDEVELOPMENTTHEIBMPRINTINGSYSTEMSDIVISIONDEPARTMENTH7FEBUILDING004MBOULDERCO80301-9191USAIfyouprefertosendcommentselectronically,useoneofthefollowingmethods:vInternet:printpub@us.
ibm.
comvFax:1-800-524-1519or1-303-924-6873InternetVisitourhomepagesathttp://www.
ibm.
com/printers/andhttp://www.
ibm.
com/servers/eserver/zseries/zos/.
WhenyousendinformationtoIBM,yougrantIBManonexclusiverighttouseordistributetheinformationinanywayitbelievesappropriatewithoutincurringanyobligationtoyou.
CopyrightInternationalBusinessMachinesCorporation19992002.
Allrightsreserved.
USGovernmentUsersRestrictedRights–Use,duplicationordisclosurerestrictedbyGSAADPScheduleContractwithIBMCorp.
ContentsFiguresviiTablesixSummaryofChangesxiAboutThisBookxiiiWhoShouldUseThisPublicationxiiiHowThisPublicationisOrganizedxiiiWheretoFindMoreInformationxivWebSitesxivAccessingLicensedBooksontheWebxivUsingLookAttolookupmessageexplanationsxvPreventiveServicePlanningInformationxviPublicationsxviUnderstandingSyntaxNotationxviiChapter1.
MigrationOverview1TermsYouNeedtoKnow1DevelopingaMigrationStrategy2ReviewingChangestoInfoprintServerProcessing2ReviewingChangestoInfoprintServerInterfaces3ActionsRequiredforAllMigrations4MigratingfromInfoprintServerRunningonOS/390V2R8–z/OSV1R1.
.
.
.
4MigratingfromOS/390PrintServer,IPPrintWay,orNetSpool6Chapter2.
MigrationRoadmaps9OS/390V2R8toz/OSV1R2Summary9OS/390PrintServer,NetSpool,orIPPrintWaytoz/OSV1R2Summary.
.
.
.
9SummaryofPublicationChangesinOS/390V2R812Chapter3.
z/OSVersion1Release2Overview13ReleaseSummary13AFPDriverandAFPViewerNotPartofInfoprintServer.
14AOPSTARTandAOPSTOPProcedureEnhancements15IPPrintWayCopySupportforLANPrinters17IPPrintWayE-mailSupport18IPPrintWayExitEnhancement22IPPrintWayEnhancementsforPrintingtoVTAMPrinters23IPPrintWayQueryPrinterStatus25IPPrintWayResubmitforFilteringEnhancements26IPPrintWayTCP/IPConnectionTimeoutEnhancement29NetSpoolExitEnhancements31NetSpoolPCLConversion.
33PrintInterface>255CopiesSupport36PrintInterfaceInfoprintPortMonitorforWindowsEnhancements37PrintInterfaceIPPServerJavaSupport.
39PrintInterfaceRemoteTransformSupportforIBMInfoprintColor130PlusPrinter40PrintInterfaceSubsystemforBatchApplications42PSFforOS/390FSADefinitionEnhancements45SampleCustomizationFiles47SecureEnvironment48CopyrightIBMCorp.
19992002iii|||||||||||||||||||||||||||||||||||||||||||||||Chapter4.
OS/390Version2Release8Overview51ReleaseSummary51PrinterInventory53Transforms60AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransforms62KanjiAFPPrintFeature.
65TransformEnhancements66PrintInterfaceRemoteTransforms.
68PrintInterfaceIPPServer70PrintInterfaceDynamicAllocationEnhancements71PrintInterfaceAOPPRINTJCLProcedure72PrintInterfacelpCommandEnhancements73PrintInterfaceJobStatusEnhancements75PrintInterfaceSMBProtocolSupport.
76InfoprintPortMonitorforWindowsEnhancements78PrintInterfaceFilterEnhancements79PrintInterfaceAPI.
80PrintInterfaceSAPOutputManagementSystem81PrintInterfaceLPDCompatibilityFilter83NetSpoolOperatorCommandEnhancements85NetSpoolDynamicAllocationEnhancement87IPPrintWayStartupEnhancements88IPPrintWayIPPClient90IPPrintWayPrinterSelectionwithFSSDATAJCLParameter92IPPrintWayExtendedRoutingCriteria94IPPrintWayCodePageConversion96IPPrintWayPrinterInstructionEnhancements98IPPrintWayCoordinationwithPrintInterfaceandNetSpool99IPPrintWayRestrictPorts101IPPrintWayTransformFunction102IPPrintWayVTAMPrinterSupport104SNMPSubagent106PSFforOS/390StartupEnhancements108Chapter5.
SummaryofInterfaceChanges109ApplicationProgrammingInterface(API)Functions110ConfigurationFiles111DataSetsandFiles.
112EnvironmentVariables.
113Exits113FileSystems—/etcand/varDirectories122Filters122InfoprintPortMonitorforWindows124InfoprintServerISPFPanels124JCLParametersonOUTPUTandDDStatements126JobAttributes128Messages129PIDUPrinterAttributes130NetSpoolOperatorCommands131SMFType6Record132StartupandShutdownProcedures133SYS1.
MACLIBMembers134SYS1.
PROCLIBMembers135SYS1.
SAMPLIBMembers135TSOLogonProcedure137/usr/lpp/Printsrv/samples/Directory138ivz/OSV1R2.
0InfoprintServerMigration||||||z/OSUNIXCommands139Chapter6.
InfoprintServerMigrationProgram.
141RunningtheMigrationProgram142PreparingtoRuntheMigrationProgram142RunningtheMigrationProgramUsingtheaopmigCommand144RunningtheMigrationProgramfromTSO150UsingtheMigrationProgramReport152RunningthePrinterInventoryDefinitionUtility(PIDU)153RunningthePIDUProgramUsingthepiduCommand153RunningthePIDUProgramfromTSO154RerunningtheMigrationProgramandthePIDUProgram.
154ViewingandEditingthePrinterInventory155AppendixA.
MigrationReport159AppendixB.
MigrationTables169IPPrintWayRoutingDataSet169IPPrintWayOptionsDataSet169NetSpoolPrintCharacteristicsDataSet(PCDS)172NetSpoolOUTPUTStatements173NetSpoolPage-FormatTable177AppendixC.
Accessibility179UsingAssistiveTechnologies179KeyboardNavigationoftheUserInterface179Notices181Trademarks.
182Bibliography185InfoprintServer185PrintServicesFacilityforOS/390185AdvancedFunctionPresentation(AFP)185InfoprintManagerforAIXandWindows186z/OSVersion1Release2186CICS187IMS/ESAVersion61873270andSNADataStreams187Index189Contentsv||||||||viz/OSV1R2.
0InfoprintServerMigrationFigures1.
SampleJCLforRunningtheMigrationProgramfromTSO—AOPMIGRTinSYS1.
SAMPLIB1522.
SampleJCLforRunningthePIDUProgramfromTSO—AOPPIDUinSYS1.
SAMPLIB.
.
.
.
154CopyrightIBMCorp.
19992002viiviiiz/OSV1R2.
0InfoprintServerMigrationTables1.
SummaryofInfoprintServerPublicationsxvi2.
SummaryofRequiredMigrationTasksforMigratingfromInfoprintServeronOS/390V2R8andLater.
53.
SummaryofRequiredMigrationTasksforMigratingfromPrintServer,NetSpool,orIPPrintWay74.
ChangesIntroducedtoInfoprintServerinz/OSV1R2.
95.
ChangesIntroducedtoPrintInterfacecomponentofInfoprintServerinOS/390V2R8andLater106.
ChangesIntroducedtoNetSpoolinOS/390Version2Release8andLater117.
ChangesIntroducedtoIPPrintWayinOS/390Version2Release8andLater118.
AdditionalChangesIntroducedtoInfoprintServerandInfoprintServerTransformsinOS/390Version2Release8andLater119.
SummaryofInfoprintServerEnhancementsforz/OSVersion1Release21310.
SummaryofInfoprintServerEnhancementsforOS/390Version2Release85111.
SummaryofChangestoApplicationProgrammingInterface11012.
SummaryofChangestoConfigurationFiles11113.
SummaryofChangestoDataSets.
11214.
SummaryofChangestoEnvironmentVariables11315.
SummaryofChangestoExitRoutines11316.
SummaryofChangesto/etcand/varDirectories12217.
SummaryofChangestoFiltersProvidedwithInfoprintServerorInfoprintServerTransforms12318.
SummaryofChangestoInstallation-WrittenFilters12319.
SummaryofChangestotheInfoprintPortMonitorforWindows12420.
SummaryofChangestoISPFPanels.
12421.
SummaryofChangestoParametersonanOUTPUTJCLStatement12622.
SummaryofChangestoParametersonaDDJCLStatement12823.
SummaryofChangestoJobAttributes12824.
SummaryofChangestoPIDUPrinterAttributes13025.
SummaryofChangestoNetSpoolOperatorCommands13126.
SummaryofChangestoSMFType6Record13227.
SummaryofChangestoNetSpoolStartupProcedure13328.
SummaryofChangestotheIPPrintWayStartupProcedure13429.
SummaryofChangestoInfoprintServerStartupandShutdownProcedures13430.
SummaryofChangestoSYS1.
LINKLIB031.
SummaryofChangestoSYS1.
MACLIB13532.
SummaryofChangestoSYS1.
PROCLIB13533.
SummaryofChangestoSYS1.
SAMPLIB13634.
SummaryofChangestoTSOLogonProcedure13735.
SummaryofChangesto/usr/lpp/Printsrv/samples/Directory13836.
SummaryofChangestoz/OSUNIXCommands.
13937.
SummaryofMigrationTasks14238.
SummaryofInformationRequiredbytheMigrationProgram14339.
EnvironmentVariablesforRunningtheMigrationProgramfromTSO15140.
IPPrintWayRoutingEntryISPFFieldstoInfoprintServerISPFFieldsandPrinterAttributes16941.
IPPrintWayOptionsEntryISPFFieldstoInfoprintServerISPFFieldsandPrinterAttributes17042.
NetSpoolPrinterDefinitionKeywordstoInfoprintServerISPFFieldsandPrinterAttributes17343.
NetSpoolOUTPUTJCLStatementParameterstoInfoprintServerISPFFieldsandPrinterAttributes17444.
NetSpoolPage-FormatTableKeywordstoInfoprintServerISPFFieldsandPrinterAttributes177CopyrightIBMCorp.
19992002ix|||||||||||||||xz/OSV1R2.
0InfoprintServerMigrationSummaryofChangesSummaryofChangesforG544–5743-03z/OSVersion1Release2ThebookcontainsinformationpreviouslypresentedinG544-5743-02,whichsupportsz/OSVersion1Release2.
NewInformationvInformationisaddedtoindicatethisbooksupportsz/OS.
e.
vChapter3,"z/OSVersion1Release2Overview"onpage13summarizesenhancementsintroducedtoInfoprintServerforz/OSV1R2inMarch,2002.
YoumustapplythePTFslistedasdependenciestousetheseenhancements.
–PrintInterfacesubsystemforbatchapplications–InfoprintPortMonitorforWindowsenhancements–IPPrintWayresubmitforfilteringenhancements–IPPrintWayTCP/IPconnectiontimeoutenhancementvChapter5,"SummaryofInterfaceChanges"onpage109summarizesinterfacechangesintroducedtoInfoprintServer.
Thisbookcontainsterminology,maintenance,andeditorialchanges.
Technicalchangesoradditionstothetextandillustrationsareindicatedbyaverticallinetotheleftofthechange.
SummaryofChangesforG544–5743-02z/OSVersion1Release2ThebookcontainsinformationpreviouslypresentedinG544-5743-01,whichsupportsz/OSVersion1Release2.
NewInformationvChapter3,"z/OSVersion1Release2Overview"onpage13summarizesenhancementsintroducedtoInfoprintServerforz/OSV1R2inDecember,2001.
YoumustapplythePTFslistedasdependenciestousetheseenhancements.
–IPPrintWaye-mailsupport–PrintInterfaceremotetransformsupportforIBMInfoprintColor130Plusprinterv"ActionsRequiredforAllMigrations"onpage4and"NetSpoolPCLConversion"onpage33listanadditionalmigrationtaskthatisrequiredforallinstallationsthatrunNetSpool.
TheuserIDthatstartsNetSpoolmustbeaz/OSUNIXuserID.
vChapter5,"SummaryofInterfaceChanges"onpage109summarizesinterfacechangesintroducedtoInfoprintServer.
vAnappendixwithproductaccessibilityinformationhasbeenadded.
DeletedInformationTheglossaryhasbeenremovedandisnowlocatedinz/OSInfoprintServerCustomization.
CopyrightIBMCorp.
19992002xi|||||||||||||||||||||||||||||||||||||||||Thisbookcontainsterminology,maintenance,andeditorialchanges.
Technicalchangesoradditionstothetextandillustrationsareindicatedbyaverticallinetotheleftofthechange.
SummaryofChangesforG544–5743-01z/OSVersion1Release2ThebookcontainsinformationpreviouslypresentedinG544-5743-00,whichsupportsz/OSVersion1Release1.
NewInformationv"MigratingfromInfoprintServerRunningonOS/390V2R8–z/OSV1R1"onpage4describesactionsrequiredbyallinstallationsthatmigratefromInfoprintServerandInfoprintServerTransformsrunningonOS/390V2R8orlater.
Thesemigrationactionsarerequiredwhetherornotyourinstallationwantstoenableanyofthenewfunctionsintroducedinz/OSV1R2.
v"MigratingfromOS/390PrintServer,IPPrintWay,orNetSpool"onpage6describesactionsrequiredbyallinstallationsthatmigratefromOS/390PrintServerrunningonOS/390V2R5andlater,theNetSpoolfeatureofPSF,ortheIPPrintWayfeatureofPSF.
ThesemigrationactionsarerequiredwhetherornotyourinstallationwantstoenableanyofthenewfunctionsintroducedinOS/390V2R8orz/OSV1R2.
vChapter3,"z/OSVersion1Release2Overview"onpage13summarizestheupdatesthathavebeenintroducedtoInfoprintServerinz/OSV1R2anddescribesthetasksaninstallationmustperformtoenabletheseenhancements.
v"TransformEnhancements"onpage66inChapter4,"OS/390Version2Release8Overview"onpage51describesanupdatethatwasintroducedtoInfoprintServerTransforms.
ThisenhancementappliestoOS/390V2R8andalllaterreleases.
vChapter5,"SummaryofInterfaceChanges"onpage109summarizestheinterfacechangesintroducedtoInfoprintServerandInfoprintServerTransformsinz/OSV1R2.
Thisbookcontainsterminology,maintenance,andeditorialchanges.
Technicalchangesoradditionstothetextandillustrationsareindicatedbyaverticallinetotheleftofthechange.
xiiz/OSV1R2.
0InfoprintServerMigration|||||||||||||||||||||||||||||||||AboutThisBookThispublicationsummarizesenhancementsintroducedinthefollowingproducts:vInfoprintServer,anelementofz/OSVersion1Release2(5694–A01),andhigher;andanelementofz/OS.
eVersion1Release3(5655-G52),andhighervInfoprintServerTransformsVersion1Release1Modificationlevel1,aseparateIBMlicensedprogramproduct(5697–F51)Thispublicationdescribesthetasksrequiredbyallinstallationstomigratetoz/OSV1R2.
Also,foreachnewandchangedfunctionintroducedinOS/390V2R8andinz/OSV1R2,thispublicationdescribesthetasksyourinstallationmustperformtousethatfunction.
Foreachtask,itdirectsyoutotheInfoprintServerpublicationthatdescribesthetask.
WhoShouldUseThisPublicationThispublicationisintendedforanyonewhoneedstomigratetoInfoprintServerandInfoprintServerTransformsonz/OSV1R2.
HowThisPublicationisOrganizedWithinthispublication,youcanfindinformationaboutthespecificupdatesandconsiderationsthatapplytothisreleaseofInfoprintServer.
vChapter1,"MigrationOverview"onpage1ThischapterdescribeshowtodevelopaplanformigratingtothecurrentlevelofInfoprintServer.
Itdescribesothersourcesofmigrationinformationanddefinestermsusedinthispublication.
vChapter2,"MigrationRoadmaps"onpage9ThischapteridentifiesthemigrationpathsthataresupportedwiththecurrentlevelofInfoprintServer.
Italsodescribestheadditionalpublicationsthatcanassistyouwithyourmigrationtothecurrentlevel.
vChapter3,"z/OSVersion1Release2Overview"onpage13ThischapterdescribesthespecificupdatesthatweremadetoInfoprintServerforz/OSV1R2.
Foreachitem,thissectionprovidesanoverviewofthechange,adescriptionofanymigrationandcoexistencetaskstobeconsidered,andwhereyoucanfindmoredetailedinformationintheInfoprintServerlibraryorotherelementlibraries.
vChapter4,"OS/390Version2Release8Overview"onpage51ThischapterdescribesthespecificupdatesthatweremadetoInfoprintServerandInfoprintServerTransformsforOS/390V2R8.
Foreachitem,thissectionprovidesanoverviewofthechange,adescriptionofanymigrationandcoexistencetaskstobeconsidered,andwhereyoucanfindmoredetailedinformationintheInfoprintServerlibraryorotherelementlibraries.
vChapter5,"SummaryofInterfaceChanges"onpage109ThischapterprovidesasummaryofthechangestoInfoprintServerandInfoprintServerTransformsuserandprogramminginterfaces.
vChapter6,"InfoprintServerMigrationProgram"onpage141ThischapterdescribeshowtousetheInfoprintServermigrationprogram.
vAppendixA,"MigrationReport"onpage159CopyrightIBMCorp.
19992002xiii||||||||||Thisappendixdescribesindetaileachsectionofthereportcreatedbythemigrationprogram.
vAppendixB,"MigrationTables"onpage169Thisappendixcontainstablesthatshowhowthemigrationprogramconvertsinformation.
vAppendixCdescribesaccessibilityfeaturesofInfoprintServerandInfoprintServerTransforms.
WheretoFindMoreInformationThissectiondescribeswheretofindinformationrelatedtoz/OS,InfoprintServer,andInfoprintServerTransforms.
WebSitesTheseWebsitescontainrelatedinformation:vhttp://www.
ibm.
com/printers/Thissitecontainsinformationaboutprintingproducts,including:–AnoverviewofInfoprintServer,includingthesameprintingscenariosthatyoucanfindinz/OSInfoprintServerIntroduction.
–InfoprintServerpublicationsandotherpublicationsrelatedtoprinting.
ThesepublicationsareinPDFformat.
vhttp://www.
ibm.
com/printers/download.
htmlThissitecontainsdownloadsforWindowssystems,includingtheInfoprintPortMonitor,theAFPViewerplug-in,theAFPPrinterDriver,andNetworkPrinterManager(NPM)fortheWeb.
vhttp://www.
ibm.
com/servers/eserver/zseries/zos/Thissitecontainsinformationaboutz/OS.
vhttp://www.
ibm.
com/servers/eserver/zseries/zos/bkserv/Thissitecontainsz/OSdocumentation,including:–Allz/OSpublicationsinbothPDFandBookManagerformat.
–DocumentationupdatesthatresultfromAPARsandPTFs.
vhttp://ibm.
com/redbooksThissitecontainsIBMredbooks,includingaredbookforInfoprintServer.
vhttp://www.
ibm.
com/servers/eserver/zseries/zos/unix/Thissitecontainsinformationaboutz/OSUNIXSystemServices.
AccessingLicensedBooksontheWebz/OSlicenseddocumentationinPDFformatisavailableontheInternetattheIBMResourceLinkWebsiteat:http://www.
ibm.
com/servers/resourcelink/Licensedbooksareavailableonlytocustomerswithaz/OSlicense.
AccesstothesebooksrequiresanIBMResourceLinkWebuseridandpassword,andakeycode.
Withyourz/OSorderyoureceivedamemothatincludesthiskeycode.
ToobtainyourIBMResourceLinkWebuseridandpasswordlogonto:http://www.
ibm.
com/servers/resourcelink/Toregisterforaccesstothez/OSlicensedbooks:1.
LogontoResourceLinkusingyourResourceLinkuseridandpassword.
xivz/OSV1R2.
0InfoprintServerMigration||||||||||||2.
ClickonUserProfileslocatedontheleft-handnavigationbar.
3.
ClickonAccessProfile.
4.
ClickonRequestAccesstoLicensedbooks.
5.
SupplyyourkeycodewhererequestedandclickontheSubmitbutton.
Ifyousuppliedthecorrectkeycodeyouwillreceiveconfirmationthatyourrequestisbeingprocessed.
Afteryourrequestisprocessedyouwillreceiveane-mailconfirmation.
Note:Youcannotaccessthez/OSlicensedbooksunlessyouhaveregisteredforaccesstothemandreceivedane-mailconfirmationinformingyouthatyourrequesthasbeenprocessed.
Toaccessthelicensedbooks:1.
LogontoResourceLinkusingyourResourceLinkuseridandpassword.
2.
ClickonLibrary.
3.
ClickonzSeries.
4.
ClickonSoftware.
5.
Clickonz/OS.
6.
Accessthelicensedbookbyselectingtheappropriateelement.
UsingLookAttolookupmessageexplanationsLookAtisanonlinefacilitythatallowsyoutolookupexplanationsformostofthez/OS,z/VM,andVSEmessagesyouencounter,aswellassystemabendsandsomecodes.
UsingLookAttofindinformationisfasterthanaconventionalsearchbecauseinmostcasesLookAtgoesdirectlytothemessageexplanation.
YoucanaccessLookAtfromtheInternetat:http://www.
ibm.
com/servers/eserver/zseries/zos/bkserv/lookat/orfromanywhereinz/OSwhereyoucanaccessaTSOcommandline(forexample,TSOprompt,ISPF,z/OSUNIXSystemServicesrunningOMVS).
Youcanalsodownloadcodefromthez/OSCollection(SK3T-4269)andtheLookAtWebsitesoyoucanaccessLookAtfromaPalmPilot(PalmVIIxsuggested).
TouseLookAtontheInternettofindamessageexplanation,gototheLookAtWebsiteandsimplyenterthemessageidentifier(forexample,$HASP701or$HASP*).
Youcanselectaspecificreleasetonarrowyoursearch.
TouseLookAtasaTSOcommand,youmusthaveLookAtinstalledonyourhostsystem.
YoucanobtaintheLookAtcodeforTSOfromadiskonyourz/OSCollection(SK3T-4269)orfromtheLookAtWebsite.
ToobtainthecodefromtheLookAtWebsite,dothefollowing:1.
Gotohttp://www.
ibm.
com/servers/eserver/zseries/zos/bkserv/lookat/.
2.
ClickNews.
3.
ScrolltoDownloadLookAtCodeforTSOandz/VM.
4.
Clicktheftplink,whichwilltakeyoutoalistofoperatingsystems.
Clicktheappropriateoperatingsystem.
Thenclicktheappropriaterelease.
5.
Openthelookat.
mefileandfollowitsdetailedinstructions.
AboutThisBookxvAfteryouhaveLookAtinstalled,youcanaccessamessageexplanationfromaTSOcommandlinebyentering:lookatmessage-id.
LookAtwilldisplaythemessageexplanationforthemessagerequested.
Note:Somemessageshaveinformationinmorethanonebook.
Forexample,IEC192Icanbefoundinz/OSMVSSystemMessages,Vol7(IEB-IEE)andalsoinz/OSMVSRoutingandDescriptorCodes.
Forsuchmessages,LookAtdisplaysalistofbooksinwhichthemessageappears.
Youcanthenselectoneofthebookstoviewthemessageexplanation.
PreventiveServicePlanningInformationBeforeinstallingInfoprintServer,youshouldreviewthecurrentPreventiveServicePlanning(PSP)information,alsocalledthePSPbucket.
YoushouldalsoperiodicallyreviewthecurrentPSPinformation.
ThePSPupgradeIDis:ZOSV1R2;thesubsetforInfoprintServeris:INFOPRINT.
ToobtainthecurrentPSPbucket,contacttheIBMSupportCenterorusez/OSSoftwareXcel(IBMLink).
Ifyouobtainedz/OSaspartofaCBPDO,HOLDDATAandPSPinformationisincludedontheCBPDOtape;however,thisinformationmightnotbecurrentiftheCBPDOtapewasshippedseveralweekspriortoinstallation.
PublicationsSee"Bibliography"onpage185foralistofthepublicationsreferredtointhisbookandpublicationsthatcontainadditionalinformationaboutrelatedproducts.
Fortitlesandordernumbersofthebooksforallproductsthatarepartofz/OS,refertoz/OSInformationRoadmap.
InfoprintServerforz/OSImplementationRedbook,SG24-6234,isavailableontheWebat:http://ibm.
com/redbooksTable1summarizesthepublicationsintheInfoprintServerproductlibrary.
Table1.
SummaryofInfoprintServerPublicationsPublicationFormnumberz/OSInfoprintServerIntroductionIntroducesallcomponentsofInfoprintServer,includingIPPrintWay,NetSpool,andPrintInterface.
ItalsointroducesInfoprintServerTransforms.
ThispublicationcontainsprintingscenariosthatshowhowyoucanuseInfoprintServerinyourinstallation.
S544-5742z/OSInfoprintServerMigrationSummarizesthenewfunctioninInfoprintServerandInfoprintServerTransformsanddescribesthemigrationtasksrequiredtoimplementeachnewfunctioninyourinstallation.
ItalsodescribestheInfoprintServermigrationprogram,whichconvertsIPPrintWay,NetSpool,andPrintInterfaceprinterinformationtotheformatrequiredbyInfoprintServerforOS/390V2R8andhigher.
G544-5743xviz/OSV1R2.
0InfoprintServerMigration||||||Table1.
SummaryofInfoprintServerPublications(continued)PublicationFormnumberz/OSInfoprintServerCustomizationDescribescustomizationtasksforallcomponentsofInfoprintServer,includingIPPrintWay,NetSpool,andPrintInterface.
ItalsodescribescustomizationtasksforInfoprintServerTransforms.
Thispublicationdescribesrequiredenvironmentvariables,configurationfiles,startupprocedures,howtowriteexitroutinesandfilterprograms,andhowtousetheInfoprintServerAPI.
S544-5744z/OSInfoprintServerOperationandAdministrationDescribesoperatorproceduresandadministrativetasksforallcomponentsofInfoprintServer,includingIPPrintWay,NetSpool,andPrintInterface.
ThispublicationdescribeshowtostartandstopInfoprintServerandhowtheoperatorcanmanagetheIPPrintWaytransmissionqueue.
ItdescribeshowtheadministratorcancreateentriesinthePrinterInventoryusingeitherISPFpanelsorthePrinterInventoryDefinitionUtility(PIDU)program,defineNetSpoolprinterLUstoVTAM,anduseaccountingrecordswrittenbyIPPrintWay.
S544-5745z/OSInfoprintServerUser'sGuideDescribeshowtosubmitprintjobsfromremotesystems(includingWindowssystems),thelocalz/OSsystem,andVirtualTelecommunicationsAccessMethod(VTAM)applications.
Itdescribesthesez/OSUNIXcommands:afp2pcl,afp2pdf,afp2ps,cancel,lp,lpstat,pcl2afp,pdf2afp,ps2afp,andsap2afp;theAOPPRINTJCLprocedure;theAOPBATCHprogram;DDandOUTPUTJCLparameterssupportedbyInfoprintServer;andhowtodownloadandinstalltheInfoprintPortMonitorforWindows.
S544-5746z/OSInfoprintServerMessagesandDiagnosisDescribesmessagesissuedbyallcomponentsofInfoprintServer,includingIPPrintWay,NetSpool,andPrintInterface.
ItalsodescribesInfoprintServerTransformsmessagesandhowtouseInfoprintServertracingfacilitiestodiagnoseandreporterrors.
G544-5747UnderstandingSyntaxNotationThefollowingrulesapplytocodingillustrationsthroughoutthispublication:vUppercaseorboldlettersaretobecodedasshown.
vVariabledataisprintedinitalics.
Enterspecificdatatoreplacethecharactersinitalics.
vIngeneral,donotenterthefollowingsymbolsaspartofaparameteroroption:VerticalBar|Underscore___Brackets[]Braces{}vAverticalbarbetweentwovaluesmeansthatyouselectoneofthevalues.
vAnunderscoredvaluemeansthatifanoptionisnotspecified,theunderscoredvalue,calledthedefault,isused.
vBracketsaroundavaluemeanthatyoudonothavetoselectthevalue.
AboutThisBookxviivBracesaroundavaluemeanthatyoumustselectoneofthevalues.
Insomestatements,youmustenterthebraces.
Thetextidentifieswhenthebracesarerequired.
xviiiz/OSV1R2.
0InfoprintServerMigrationChapter1.
MigrationOverviewInfoprintServerwasintroducedinOS/390V2R8andenhancedagaininz/OSV1R2.
Itreplacesthefollowingproducts:vTheOS/390PrintServerelementofOS/390V2R5–V2R7vTheIPPrintWayandNetSpoolfeaturesofPSFvTheNetSpool/IPPrintWayelementofOS/390V1R3andV2R4YourplanformigratingtoInfoprintServershouldconsiderinformationfromavarietyofsources.
Thesesourcesofinformationdescribetopicssuchascoexistence,service,hardwareandsoftwarerequirements,installationandmigrationprocedures,andinterfacechanges.
Thefollowingdocumentation,whichissuppliedwithyourproductorder,providesinformationaboutinstallingyourz/OSsystem.
InadditiontospecificinformationaboutInfoprintServer,thisdocumentationcontainsinformationaboutallofthez/OSelements.
vz/OSandz/OS.
ePlanningforInstallationThisbookdescribestheinstallationrequirementsforz/OSatasystemandelementlevel.
Itincludeshardware,software,andservicerequirementsforboththedrivingandtargetsystems.
Italsodescribesanycoexistenceconsiderationsandactions.
vz/OSProgramDirectoryThisdocument,whichisprovidedwithyourz/OSproductorder,leadsyouthroughthespecificinstallationstepsforInfoprintServerandtheotherz/OSelements.
vServerPacInstallingYourOrderThisistheorder-customized,installationbookforusingtheServerPacInstallationmethod.
Besuretoreview"AppendixA.
ProductInformation",whichdescribesdatasetssupplied,jobsorproceduresthathavebeencompletedforyou,andproductstatus.
IBMmighthaverunjobsormadeupdatestoPARMLIBorothersystemcontroldatasets.
Theseupdatescouldaffectyourmigration.
TermsYouNeedtoKnowThissectiondescribessometermsyoumightneedtoknowasyouusethisbook.
MigrationActivitiesthatrelatetotheinstallationofanewversionorreleaseofaprogramtoreplaceanearlierlevel.
Completionoftheseactivitiesensuresthattheapplicationsandresourcesonyoursystemwillfunctioncorrectlyatthenewlevel.
CoexistenceTwoormoresystemsatdifferentlevels(forexample,software,serviceoroperationallevels)thatshareresources.
Coexistenceincludestheabilityofasystemtorespondinthefollowingwaystoanewfunctionthatwasintroducedonanothersystemwithwhichitsharesresources:ignoreanewfunction,terminategracefully,supportanewfunction.
CopyrightIBMCorp.
199920021|||||DevelopingaMigrationStrategyTherecommendedstepsformigratingtoInfoprintServerare:1.
Becomefamiliarwiththesupportingmigrationandinstallationdocumentationfortherelease.
YoushoulddeterminewhatupdatesareneededforproductsthataresuppliedbyIBM,systemlibraries,andnon-IBMproducts.
Reviewthez/OSandz/OS.
ePlanningforInstallationbookandthez/OSIntroductionandReleaseGuideforinformationaboutInfoprintServerandotherz/OSelements.
2.
Developamigrationplanforyourinstallation.
WhenplanningtomigratetoanewreleaseofInfoprintServer,youmustconsiderhigh-levelsupportrequirements,suchasmachineandprogrammingrestrictions,migrationpaths,andprogramcompatibility.
3.
Obtainandinstallanyrequiredprogramtemporaryfixes(PTFs)orupdatedversionsoftheoperatingsystem.
CalltheIBMSoftwareSupportCentertoobtainthepreventiveserviceplanning(PSP)upgradeforInfoprintServer,whichprovidesthemostcurrentinformationaboutPTFsforInfoprintServer.
CheckRETAINagainjustbeforetestingInfoprintServer.
ForinformationabouthowtorequestthePSPupgrade,refertothez/OSProgramDirectory.
Althoughthez/OSProgramDirectorycontainsalistoftherequiredPTFs,themostcurrentinformationisavailablefromtheIBMSoftwareSupportCenter.
4.
Installtheproductusingthez/OSProgramDirectoryortheServerPacInstallingYourOrderdocumentation.
5.
Contactsystemprogrammersandadministratorswhoareresponsibleformaintainingyourprinterinformationandupdatingapplicationsatyourinstallation.
RuntheInfoprintServermigrationprogramtoconvertexistingprinterinformationtothenewformat.
Performadditionalrequiredcustomization.
TherequiredtasksdependonthecomponentsofInfoprintServeryourinstallationusedinpreviousreleases.
Verifythatyourinstallation'sapplicationswillcontinuetorun,and,ifnecessary,makechangestoensurecompatibilitywiththenewrelease.
6.
Usethenewreleasebeforeinitializingmajornewfunction.
7.
Ifnecessary,customizethenewfunctionforyourinstallation.
8.
Exercisethenewfunctions.
ReviewingChangestoInfoprintServerProcessingAsyoudefineyourinstallation'smigrationplan,considerhowthenewandchangedInfoprintServersupportmightaffectthefollowingareasofInfoprintServerprocessing.
ForeachitemdescribedinChapter3,"z/OSVersion1Release2Overview"onpage13andChapter4,"OS/390Version2Release8Overview"onpage51,youshouldreviewthe"WhatThisChangeAffects"and"MigrationProcedures"sectionstodeterminehow,orif,thesupportaffectsthetasksthatareperformedatyourinstallation.
AdministrationPrinteradministratorsmustbeawareofhowchangesintroducedbyanewproductreleasecanaffectaninstallation'sprinterinformation.
ApplicationDevelopmentApplicationdevelopmentprogrammersmustbeawareofnewfunctionsintroducedinanewreleaseofInfoprintServer.
ToensurethatexistingprogramsMigrationOverview2z/OSV1R2.
0InfoprintServerMigrationrunasbefore,yourapplicationprogrammersneedtoknowaboutanychangesindataareasandprocessingrequirements.
Thisbookprovidesanoverviewofthechangesthatmightaffectexistingapplicationprograms.
AuditingTypically,auditorsareresponsibleforensuringproperaccesscontrolandaccountabilityfortheirinstallation.
Thisbookidentifiesanychangestosecurityoptions,auditrecords,andreportgenerationutilities.
CustomizationTomeetthespecificrequirementsofyourinstallation,youcancustomizeInfoprintServerfunctionstotakeadvantageofnewsupportaftertheproductisinstalled.
Forexample,youcantailorInfoprintServerthroughtheuseofenvironmentvariables,PrinterInventoryentries,orexitroutines.
ThisbooklistschangestoInfoprintServerthatmightrequireyourinstallationtotailortheproduct,eithertoensurethatInfoprintServerrunsasbeforeortoaccommodatenewfunctionsthatyourinstallationmightneed.
DiagnosisThenewreleasemightintroducechangestodiagnosticprocedures,suchashowtoobtainatraceorreportproblemstoIBM.
Thisbookidentifiesthosechanges.
GeneralUserThisbookprovidesanoverviewofthechangesthatmightaffectexistingproceduresforgeneralusers.
InfoprintServergeneralusersuseInfoprintServercommandsandothercommandsandapplicationsto:vSubmitaprintjobvTransformfilesfromonedataformattoanothervQuerythestatusofprintersvCancelaprintjobOperationsNewInfoprintServerreleasesmightintroducechangestoitsoperatingcharacteristics,suchaschangedcommands,neworchangedmessages,orinthemethodsofimplementingnewfunctions.
Thisbookidentifiesthosechangesforwhichyoushouldprovideeducationbeforerunningthisreleaseoftheproduct.
ReviewingChangestoInfoprintServerInterfacesWhendefiningyourinstallation'smigrationplan,alsoconsiderthatInfoprintServerinterfacesmightbeaffectedbytheneworchangedfunctionsthatareintroducedinthisrelease.
Theseinterfacesinclude:vApplicationProgrammingInterfacefunctionsvConfigurationfilesvDatasetsandfilesvEnvironmentvariablesvExitsvFilesystems—/etcand/vardirectoriesMigrationOverviewChapter1.
MigrationOverview3vFiltersvInfoprintPortMonitorforWindowsvISPFpanelsvJCLparametersofDDandOUTPUTstatementsvJobattributesvMessagesvNetSpooloperatorcommandsvSMFtype6recordvStartupproceduresvSYS1.
MACLIBmembersvSYS1.
PROCLIBmembersvSYS1.
SAMPLIBmembersvPIDUprinterattributesvTSOlogonproceduresv/usr/lpp/Printsrv/samplesdirectoryvz/OSUNIXcommandsChapter5,"SummaryofInterfaceChanges"onpage109providesasummaryofthechangesthataffecttheseinterfacesfortherelease.
Thisinformationisalsolistedinthe"WhatThisChangeAffects"sectionthatisprovidedforeachreleaseenhancementinChapter4,"OS/390Version2Release8Overview"onpage51.
ActionsRequiredforAllMigrationsThissectiondescribescommonmigrationactivitiesthatallinstallationsmustperform:vIfyourinstallationcurrentlyrunsInfoprintServeronOS/390V2R8-V2R10orz/OSV1R1,see"MigratingfromInfoprintServerRunningonOS/390V2R8–z/OSV1R1".
vIfyourinstallationcurrentlyrunsthePrintServeronOS/390V2R5-V2R7;theNetSpoolorIPPrintWayfeatureofPSF;ortheNetSpool/IPPrintWayelementofOS/390V1R3orV2R4,see"MigratingfromOS/390PrintServer,IPPrintWay,orNetSpool"onpage6.
MigratingfromInfoprintServerRunningonOS/390V2R8–z/OSV1R1IfyoucurrentlyrunInfoprintServeronOS/390V2R8-V2R10orz/OSV1R1,youmustperformthemigrationtasksdescribedinthissection.
Table2onpage5liststherequiredmigrationtasksandreferstothepublicationthatdescribeseachtask.
Also,seeChapter3,"z/OSVersion1Release2Overview"onpage13forasummaryoftheenhancementsintroducedinInfoprintServerforz/OSV1R2andthetasksthatapplyifyouwanttoenableanyoftheseenhancementsinyourinstallation.
MigrationOverview4z/OSV1R2.
0InfoprintServerMigration||||||||||||||||Table2.
SummaryofRequiredMigrationTasksforMigratingfromInfoprintServeronOS/390V2R8andLaterMigrationTaskReferenceInformationSavethedirectorythatcontainstheInfoprintServerPrinterInventoryfiles.
Thedefaultdirectoryis/var/Printsrv;however,yourinstallationmighthavechangedthedirectorynameinthebase-directorystatementintheInfoprintServerconfigurationfile,aopd.
conf.
TheformatofthePrinterInventoryhasnotchangedinz/OSV1R2;therefore,youcancontinuetousethesamePrinterInventorythatyouuseinOS/390V2R8andlaterreleases.
z/OSInfoprintServerCustomizationIfyourinstallationmodifiedtheInfoprintServerconfigurationfile,savethefile.
Itsdefaultlocationis/etc/Printsrv/aopd.
conf;however,yourinstallationmighthavespecifiedadifferentlocationinenvironmentvariableAOPCONF.
z/OSInfoprintServerCustomizationSpecifyenvironmentvariablesintheaopstartEXECifanyofthefollowingconditionsapply:vInfoprintServerexecutablefiles,messagefiles,andconfigurationfilesarenotinthedefaultlocationsvInfoprintServerTransformsconfigurationfilesarenotinthedefaultlocationsvLEandC++run-timelibrariesarenotinSYS1.
LNKLSTvYouhavedefinedmultipleTCP/IPstacksvYouruntheInfoprintServerSAPOutputManagementSystem(OMS)vYourunthePrintInterfaceIPPserverandJava1.
3librariesarenotinthedefaultdirectoriesvYouwanttochangethedefaulttracedirectoryz/OSInfoprintServerCustomizationIfyouusetheAOPSTARTprocedure,specifytheAOPTRACEONandLANGenvironmentvariablesintheSTDENVdatasetinthenewprocedureifyouwanttotraceInfoprintServerorviewInfoprintServermessagesinJapanese.
z/OSInfoprintServerCustomizationPerformthefollowingtasksifyoucurrentlyrunPrintInterface:Saveanydatastreamfiltersyourinstallationhaswritten.
Thefiltersdonotneedtoberecompiled.
z/OSInfoprintServerCustomizationPerformthefollowingtasksifyoucurrentlyrunInfoprintServerTransforms:Ifyourinstallationmodifiedthedefaulttransformconfigurationfile,savethefile.
Itsdefaultlocationis/etc/Printsrv/aopxfd.
conf;however,yourinstallationmighthavespecifiedadifferentlocationinenvironmentvariableAOPXFD_CONF.
z/OSInfoprintServerCustomizationIfyourinstallationmodifiedtheconfigurationfilesfortheSAPtoAFPtransform,savethedirectorythatcontainsthefiles.
Thedefaultdirectoryis/usr/lpp/Printsrv/sap2afp;however,ifyourinstallationmodifiedthesefiles,themodifiedfilesareinthedirectorynamedinenvironmentvariableAOP_SAP2AFP_RESOURCES.
z/OSInfoprintServerCustomizationIfyourinstallationmodifiedtheUserInitorpreload.
psconfigurationfileforthePostScripttoAFPtransform,oraddedfontsforthetransform,savethedirectorythatcontainsthemodifiedfilesandfonts.
ThisdirectoryisnamedinenvironmentvariableAOP_RESOURCE_PATH,whichisspecifiedintheps2afptransformentryinthetransformconfigurationfile,aopxfd.
conf.
z/OSInfoprintServerCustomizationIfyourinstallationmodifiedthemultibyteconversiontablesfortheSAPtoAFPtransform,savethedirectorythatcontainsthefiles,/usr/lib/nls/locale/uconvTable.
z/OSInfoprintServerCustomizationMigrationOverviewChapter1.
MigrationOverview5||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||Table2.
SummaryofRequiredMigrationTasksforMigratingfromInfoprintServeronOS/390V2R8andLater(continued)MigrationTaskReferenceInformationIfyourinstallationmodifiedthefont-mappingtable,AOXFONTS,usedbytheAFPtoPCL,AFPtoPDF,andAFPtoPostScripttransforms,applyusermodstoinstallthemodifiedfont-mappingtableineachAFPtransform.
z/OSInfoprintServerCustomizationIfyourinstallationscaled240-pelfontsto300-pelfontsforusewiththeAFPtoPCL,AFPtoPDF,andAFPPostScripttransforms,savethedatasetthatcontainsthe300–pelfonts.
z/OSInfoprintServerCustomizationPerformthefollowingtaskifyoucurrentlyrunNetSpool:EnsurethattheuserIDthatstartsNetSpoolisaz/OSUNIXuserID.
TheuserIDmusthaveanOMVSsegmentandahomedirectory.
z/OSInfoprintServerCustomizationIfyourinstallationdoesnotaddtheLEandC++run-timelibrariestothesystemLNKLST,addtheCEE.
SCEERUNandCBC.
SCLBDLLdatasetstotheNetSpoolstartupprocedures,andrestartNetSpool.
z/OSInfoprintServerCustomizationSaveanyNetSpoolexitsyourinstallationhaswritten.
Theexitsdonotneedtoberecompiledunlessyouwanttousenewfunctions.
z/OSInfoprintServerCustomizationPerformthefollowingtaskifyoucurrentlyrunIPPrintWay:SaveanyIPPrintWayexitsyourinstallationhaswritten.
Theexitsdonotneedtoberecompiledunlessyouwanttousenewfunctions.
z/OSInfoprintServerCustomizationPerformthefollowingtaskifyouusetheAFPPrinterDriverorAFPViewer:DownloadtheAFPDriverandAFPViewerfromtheIBMPrintingSystemsDivision(PSD)Websiteinsteadoffromaz/OSdirectory.
TheIBMPSDWebsiteaddressfordownloadsis:http://www.
ibm.
com/printers/dowload.
htmlz/OSInfoprintServerUser'sGuidePerformthefollowingtasksifyoucurrentlyruntheInfoprintServerIPPServer:IfyourinstallationcurrentlyrunsJava1.
1.
8,installJava1.
3.
IfyoudidnotinstallJava1.
3librariesinthedefaultdirectories,specifytheJavadirectoryintheJAVA_HOMEenvironmentvariableinthenewaopstartEXEC.
RuntheAOPJAUTHprogramtoauthorizetheJavalibraries.
YourinstallationrunstheInfoprintServerIPPServerifthestart-daemons=ippdattributeisspecifiedintheInfoprintServerconfigurationfile.
Itsdefaultlocationis/etc/Printsrv/aopd.
conf;however,yourinstallationmighthavespecifiedadifferentlocationinenvironmentvariableAOPCONF.
z/OSInfoprintServerCustomizationMigratingfromOS/390PrintServer,IPPrintWay,orNetSpoolIfyoucurrentlyrunthe(1)OS/390PrintServerelementofOS/390V2R5-V2R7,(2)NetSpoolorIPPrintWayfeatureofPSF,or(3)NetSpool/IPPrintWayelementofOS/390V1R3orV2R4,youmustperformthemigrationtasksdescribedinthissection.
Table3onpage7summarizestherequiredmigrationtasksandreferstothepublicationorchapterthatdescribeseachtask.
Also,seeChapter3,"z/OSVersion1Release2Overview"onpage13andChapter4,"OS/390Version2Release8Overview"onpage51forasummaryoftheenhancementsintroducedinInfoprintServerinOS/390V2R8andz/OSV1R2andthetasksthatapplyifyouwanttoenableanyoftheseenhancementsinyourinstallation.
MigrationOverview6z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||Table3.
SummaryofRequiredMigrationTasksforMigratingfromPrintServer,NetSpool,orIPPrintWayMigrationTaskReferenceInformationCustomizethePrinterInventoryManagercomponentofInfoprintServer.
IfyourinstallationcurrentlyrunsPrintInterface,youhavealreadycustomizedthePrinterInventoryManager.
Therefore,youneedtoperformonlythefollowingsubsetofcustomizationtasks:vSaveyourPrintInterfaceconfigurationfileinthesamedirectory;itsdefaultlocationis/etc/Printsrv/aopd.
conf.
vChangetheNLSPATHenvironmentvariablein/etc/profiletospecify/usr/lpp/Printsrv/En_US/%Nor/usr/lpp/Printsrv/%L/%N.
(NotethechangetoanuppercaseEinEn_US.
)vLibraryAOP.
SAOPEXECreplacesANF.
SANFEXEC.
ConcatenatelibraryAOP.
SAOPEXECtotheSYSEXECstatementinyourTSOlogonprocedures,andremovetheANF.
SANFEXEClibrary.
vSpecifyenvironmentvariablesintheaopstartEXECifanyofthefollowingconditionsapply:–InfoprintServerexecutablefiles,messagefiles,andconfigurationfilesarenotinthedefaultlocations–InfoprintServerTransformsconfigurationfilesarenotinthedefaultlocations–LEandC++run-timelibrariesarenotinSYS1.
LNKLST–YouhavedefinedmultipleTCP/IPstacks–YouruntheInfoprintServerSAPOutputManagementSystem(OMS)–YourunthePrintInterfaceIPPserverandJava1.
3librariesarenotinthedefaultdirectories–Youwanttochangethedefaulttracedirectoryz/OSInfoprintServerCustomizationStartthePrinterInventoryManagerdaemon(aopd).
StartthisdaemonbeforecreatinganyobjectsinthePrinterInventoryandbeforeyoustartNetSpoolorIPPrintWay.
z/OSInfoprintServerOperationandAdministrationRuntheInfoprintServermigrationprogramandthePIDUprogramtoconvertexistingprinterinformationforIPPrintWay,NetSpool,andPrintInterfacetotheformatrequiredbythenewInfoprintServerPrinterInventoryintroducedinOS/390V2R8.
Chapter6,"InfoprintServerMigrationProgram"onpage141PerformthefollowingtasksifyoucurrentlyrunIPPrintWay:EnsurethattheuserIDthatstartsIPPrintWayisaz/OSUNIXuserID.
TheuserIDmusthaveanOMVSsegmentandahomedirectory.
z/OSInfoprintServerCustomizationDeleteyourexistingIPPrintWaytransmissionqueuedataset;allocateandinitializeanewtransmission-queuedataset,ANF.
QUEUE,usingnewallocationparameters.
z/OSInfoprintServerCustomizationChangeyourIPPrintWaystartupproceduretospecifytheINVparameter(withthenameofthePrinterInventory)andtoremoveunusedparameters.
RestartIPPrintWayFSAsandFSSusingthenewstartupprocedure.
z/OSInfoprintServerCustomizationRemoveV2R5-V2R7IPPrintWaylibrariesfromyourTSOlogonprocedures;IPPrintWaylibrarieshavehighlevelqualifierANF.
z/OSInfoprintServerCustomizationRecompileanyIPPrintWayexitsyourinstallationhaswritten.
z/OSInfoprintServerCustomizationPerformthefollowingtasksifyoucurrentlyrunNetSpool:MigrationOverviewChapter1.
MigrationOverview7||||||||||||||||||||Table3.
SummaryofRequiredMigrationTasksforMigratingfromPrintServer,NetSpool,orIPPrintWay(continued)MigrationTaskReferenceInformationEnsurethattheuserIDthatstartsNetSpoolisaz/OSUNIXuserID.
TheuserIDmusthaveanOMVSsegmentandahomedirectory.
z/OSInfoprintServerCustomizationChangeyourNetSpoolstartupproceduretospecifytheINVparameter(withthenameofthePrinterInventory)andtoremovetheWTORparameter.
RestarttheNetSpoolprogramusingthenewstartupprocedure.
z/OSInfoprintServerCustomizationIfyourinstallationdoesnotaddtheLEandC++run-timelibrariestothesystemLNKLST,addtheCEE.
SCEERUNandCBC.
SCLBDLLdatasetstotheNetSpoolstartupprocedures,andrestartNetSpool.
z/OSInfoprintServerCustomizationLink-editanyNetSpoolexitsyourinstallationhaswrittenintoanAPF-authorizedlibrary.
z/OSInfoprintServerCustomizationMigrationOverview8z/OSV1R2.
0InfoprintServerMigration|||||||||||||Chapter2.
MigrationRoadmapsThissectiondescribesthemigrationpathsthataresupportedbythecurrentreleaseofInfoprintServerandInfoprintServerTransforms.
Selecttheroadmapthatappliestoyourmigrationpathandreviewthechangesfortheassociatedreleases.
OS/390V2R8toz/OSV1R2SummaryThissectionsummarizestheupdatesthathavebeenintroducedtoInfoprintServerinz/OSVersion1Release2(V1R2).
UsethetableinthissectionifyouaremigratingfromInfoprintServerrunningonanearlierreleaseofOS/390orz/OS.
Table4.
ChangesIntroducedtoInfoprintServerinz/OSV1R2ForInformationAbout:SeePage:AFPDriverandAFPViewerNotPartofInfoprintServer14AOPSTARTandAOPSTOPProcedureEnhancements15IPPrintWayCopySupportforLANPrinters17IPPrintWayE-mailSupport18IPPrintWayExitEnhancement22IPPrintWayEnhancementsforPrintingtoVTAMPrinters23IPPrintWayQueryPrinterStatus25IPPrintWayResubmitforFilteringEnhancements26IPPrintWayTCP/IPConnectionTimeoutEnhancement29NetSpoolExitEnhancements31NetSpoolPCLConversion33PrintInterface>255CopiesSupport36PrintInterfaceInfoprintPortMonitorforWindowsEnhancements37PrintInterfaceIPPServerJavaSupport39PrintInterfaceRemoteTransformSupportforIBMInfoprintColor130PlusPrinter40PrintInterfaceSubsystemforBatchApplications42PSFforOS/390FSADefinitionEnhancements45SampleCustomizationFiles47SecureEnvironment48OS/390PrintServer,NetSpool,orIPPrintWaytoz/OSV1R2SummaryThissectionsummarizestheupdatesthathavebeenintroducedtoInfoprintServerandInfoprintServerTransformsinOS/390Version2Release8(V2R8)andinz/OSVersion1Release2(V1R2).
UsethetablesinthissectionifyouaremigratingfromOS/390PrintServer.
UsethetablesthatdescribeupdatestotheNetSpoolorIPPrintWaycomponentsofInfoprintServerifyouaremigratingfromanyofthefollowingpreviouslevelsofNetSpoolorIPPrintWay:vNetSpoolfeatureofPSFrunningonanyreleaseofMVS,OS/390,orz/OSvIPPrintWayfeatureofPSFrunningonanyreleaseofMVS,OS/390,orz/OSvNetSpool/IPPrintWayrunningonOS/390V1R3orOS/390V2R4CopyrightIBMCorp.
199920029||||||||||||||||||||||||||||||||||||||||||||||||||||||||Table5summarizesthechangesthatwereintroducedtothePrintInterfacecomponentofInfoprintServerinOS/390V2R8andz/OSV1R2.
IfyourinstallationcurrentlyrunsapreviouslevelofPrintInterfaceyoushouldreviewtheinformationinthedetailedsectionforeachiteminthetable.
Table5.
ChangesIntroducedtoPrintInterfacecomponentofInfoprintServerinOS/390V2R8andLaterForInformationAbout:SeePage:ChangesIntroducedinz/OSV1R2PrintInterface>255CopiesSupport36PrintInterfaceInfoprintPortMonitorforWindowsEnhancements37PrintInterfaceIPPServerJavaSupport39PrintInterfaceRemoteTransformSupportforIBMInfoprintColor130PlusPrinter40PrintInterfaceSubsystemforBatchApplications42ChangesIntroducedinOS/390V2R8PrinterInventory53PrintInterfaceRemoteTransforms68PrintInterfaceIPPServer70PrintInterfaceDynamicAllocationEnhancements71PrintInterfaceAOPPRINTJCLProcedure72PrintInterfacelpCommandEnhancements73PrintInterfaceJobStatusEnhancements75PrintInterfaceSMBProtocolSupport76InfoprintPortMonitorforWindowsEnhancements78PrintInterfaceFilterEnhancements79PrintInterfaceAPI80PrintInterfaceSAPOutputManagementSystem81PrintInterfaceLPDCompatibilityFilter83Table6onpage11summarizesthechangesthatwereintroducedtotheNetSpoolcomponentofInfoprintServerinz/OSV1R2andinOS/390V2R8.
IfyourinstallationcurrentlyrunsapreviouslevelofNetSpool,youshouldreviewtheinformationinthedetailedsectionforeachiteminthetable.
MigrationRoadmaps10z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||||Table6.
ChangesIntroducedtoNetSpoolinOS/390Version2Release8andLaterForInformationAbout:SeePage:ChangesIntroducedinz/OSV1R2NetSpoolExitEnhancements31NetSpoolPCLConversion33ChangesIntroducedinOS/390V2R8PrinterInventory53NetSpoolOperatorCommandEnhancements85NetSpoolDynamicAllocationEnhancement87Table7summarizesthechangesthatwereintroducedtotheIPPrintWaycomponentofInfoprintServerinz/OSV1R2andinOS/390V2R8.
IfyourinstallationcurrentlyrunsapreviouslevelofIPPrintWay,youshouldreviewtheinformationinthedetailedsectionforeachiteminthetable.
Table7.
ChangesIntroducedtoIPPrintWayinOS/390Version2Release8andLaterForInformationAbout:SeePage:ChangesIntroducedinz/OSV1R2IPPrintWayCopySupportforLANPrinters17IPPrintWayE-mailSupport18IPPrintWayExitEnhancement22IPPrintWayEnhancementsforPrintingtoVTAMPrinters23IPPrintWayQueryPrinterStatus25IPPrintWayResubmitforFilteringEnhancements26IPPrintWayTCP/IPConnectionTimeoutEnhancement29ChangesIntroducedinOS/390V2R8PrinterInventory53IPPrintWayStartupEnhancements88IPPrintWayIPPClient90IPPrintWayPrinterSelectionwithFSSDATAJCLParameter92IPPrintWayExtendedRoutingCriteria94IPPrintWayCodePageConversion96IPPrintWayPrinterInstructionEnhancements98IPPrintWayCoordinationwithPrintInterfaceandNetSpool99IPPrintWayRestrictPorts101IPPrintWayTransformFunction102IPPrintWayVTAMPrinterSupport104Table8onpage12summarizestheenhancementsthatwereintroducedtoInfoprintServerandInfoprintServerTransformsinz/OSV1R2andOS/390V2R8thatarenotspecifictothePrintInterface,NetSpool,orIPPrintWaycomponents.
IfyoucurrentlyrunPrintInterface,NetSpool,orIPPrintWay,youshouldreviewtheinformationinthedetailedsectionforeachitem.
MigrationRoadmapsChapter2.
MigrationRoadmaps11||||||||||||||||||||||||||Table8.
AdditionalChangesIntroducedtoInfoprintServerandInfoprintServerTransformsinOS/390Version2Release8andLaterForInformationAbout:SeePage:ChangesIntroducedinz/OSV1R2AFPDriverandAFPViewerNotPartofInfoprintServer14AOPSTARTandAOPSTOPProcedureEnhancements15PSFforOS/390FSADefinitionEnhancements45SampleCustomizationFiles47SecureEnvironment48ChangesIntroducedinOS/390V2R8Transforms60AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransforms62KanjiAFPPrintFeature65TransformEnhancements66SNMPSubagent106PSFforOS/390StartupEnhancements108SummaryofPublicationChangesinOS/390V2R8TheInfoprintServerlibrarywasreorganizedinOS/390V2R8.
Inpreviousreleases,aseparatepublicationforeachcomponent(PrintInterface,IPPrintWay,andNetSpool)describedthecustomization,administrative,operational,anddiagnostictasksforthatcomponent.
StartingwithOS/390V2R8,theinformationforallcomponentsiscentralizedinacommonlibraryofInfoprintServerpublications.
Forexample,customizationinformationpreviouslyinthe"NetSpoolGuide",the"IPPrintWayGuide",andthe"PrintInterfaceCustomizationGuide"cannowbefoundinz/OSInfoprintServerCustomization.
Inaddition,theInfoprintServerISPFhelppanelscontainmoreintegratedproductinformation.
TheadministratorusestheInfoprintServerISPFpanelstocreateandmanageentriesinthePrinterInventory.
Field-specificinformation(suchasallowedvalues,defaults,andfieldinteractions)previouslycontainedintheindividualcomponentpublicationscannowbefoundintheonlinehelpfortheInfoprintServerpanelsandfields.
"WheretoFindMoreInformation"onpagexivdescribesthecontentsofthepublicationsintheInfoprintServerlibrary.
MigrationRoadmaps12z/OSV1R2.
0InfoprintServerMigration||||||||||||||Chapter3.
z/OSVersion1Release2OverviewThefollowingsectionsdescribethenewandchangedfunctionsthatwereintroducedtoInfoprintServerinz/OSVersion1Release2(V1R2).
Theinformationabouteachitemincludes:vDescriptionvSummaryoftheInfoprintServertasksorinterfacesthatmaybeaffectedvCoexistenceconsiderations,ifany,thatareassociatedwiththeitemvMigrationtasks,ifany,thatareassociatedwiththeitemvReferencestootherpublicationsthatcontainadditionaldetailedinformationNote:Somemigrationtasksarerequiredwhetherornotyourinstallationplanstouseaneworchangedfunction.
See"ActionsRequiredforAllMigrations"onpage4forthemigrationtasksthatarerequiredbyallinstallations,evenifyourinstallationdoesnotplantoimplementanyofthenewfunctions.
ReleaseSummaryTable9summarizestheupdatesthathavebeenmadetoInfoprintServerinz/OSV1R2.
Formoreinformation,seethedetailedsectionforeachitem.
Table9.
SummaryofInfoprintServerEnhancementsforz/OSVersion1Release2ForInformationAbout:SeePage:AFPDriverandAFPViewerNotPartofInfoprintServer14AOPSTARTandAOPSTOPProcedureEnhancements15IPPrintWayCopySupportforLANPrinters17IPPrintWayE-mailSupport18IPPrintWayExitEnhancement22IPPrintWayEnhancementsforPrintingtoVTAMPrinters23IPPrintWayQueryPrinterStatus25IPPrintWayResubmitforFilteringEnhancements26IPPrintWayTCP/IPConnectionTimeoutEnhancement29NetSpoolExitEnhancements31NetSpoolPCLConversion33PrintInterface>255CopiesSupport36PrintInterfaceInfoprintPortMonitorforWindowsEnhancements37PrintInterfaceIPPServerJavaSupport39PrintInterfaceRemoteTransformSupportforIBMInfoprintColor130PlusPrinter40PrintInterfaceSubsystemforBatchApplications42PSFforOS/390FSADefinitionEnhancements45SampleCustomizationFiles47SecureEnvironment48CopyrightIBMCorp.
1999200213||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||AFPDriverandAFPViewerNotPartofInfoprintServerDescriptionTheAFPDriverforWindowsandtheAFPViewerplug-inforWindowsarenolongershippedaspartofInfoprintServer.
TheseproductsarestillavailableatnochargefromtheIBMPrintingSystemsDivisionWebsiteat:http://www.
ibm.
com/printers/download.
htmlWhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationTheWindowsadministratormustdownloadtheAFPDriverfromtheWebwhendefiningasharedWindowsprinter.
DiagnosisNone.
GeneralUserTheWindowsusermustdownloadtheAFPViewerandAFPDriverfromtheWeb.
OperationsNone.
InterfacesNone.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationDownloadtheAFPDriverandAFPViewerfromtheWebinsteadoffromz/OS.
Requiredz/OSInfoprintServerUser'sGuideForMoreInformationFormoredetailedinformationaboutthissupport,refertoz/OSInfoprintServerUser'sGuide.
AFPDriver,AFPViewer14z/OSV1R2.
0InfoprintServerMigration|||||||||||||||||||||||||||||||||||||||||||||||||||AOPSTARTandAOPSTOPProcedureEnhancementsDescriptionInfoprintServerhasenhancedtheAOPSTARTandAOPSTOPprocedures,whichyoucanusetostartandstopInfoprintServerdaemons:vTheAOPSTARTprocedurenowletsyouspecifytheAOPTRACEONandLANGenvironmentvariablesinafilereferredtobytheSTDENVDDstatementintheAOPSTARTprocedure.
TheAOPSTARTprocedurenolongerusesanyenvironmentvariablesthataresetinthe/etc/profilefile.
vTheAOPSTOPprocedurenowletsyouspecifyoptionswhenyouusetheprocedure.
Theseoptionsletyoustopselecteddaemonsandcontrolwhenthedaemonsarestopped.
Inthepreviousrelease,youhadtoedittheAOPSTOPprocedureorusethez/OSUNIXaopstopcommandinordertostopselecteddaemons.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationThesystemprogrammernowmustspecifytheLANGvariableintheSTDENVdatasettoviewJapanesemessages.
DiagnosisThediagnosticiannowmustspecifytheAOPTRACEONvariableintheSTDENVdataset.
GeneralUserNone.
OperationsTheoperatorcanspecifyoptionsontheAOPSTOPproceduretostopselecteddaemons.
InterfacesSeeTable32onpage135.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatusethisfunction.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationSpecifytheAOPTRACEONandLANGenvironmentvariablesintheSTDENVdatasetinthenewAOPSTARTprocedureifyouwanttotraceInfoprintServerorviewInfoprintServermessagesinJapanese.
Optionalz/OSInfoprintServerCustomization,z/OSInfoprintServerMessagesandDiagnosisSpecifyAOPSTOPprocedureoptionsifyouwanttostopindividualInfoprintServerdaemons.
Optionalz/OSInfoprintServerOperationandAdministrationAOPSTARTandAOPSTOPEnhancementsChapter3.
z/OSVersion1Release2Overview15||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||ForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerMessagesandDiagnosisAOPSTARTandAOPSTOPEnhancements16z/OSV1R2.
0InfoprintServerMigration|||||IPPrintWayCopySupportforLANPrintersDescriptionTheIPPrintWaycomponentofInfoprintServernowcanprintmorethanonecopyofadocumentonanyremoteprinterorprintserverthateithercontainsalineprinterdaemon(LPD)orsupportsthedirectsocketsprintingprotocol.
IPPrintWaynowtransmitsadatasetmultipletimestotheprinter,whileensuringthatallcopiesofthedatasetprinttogether.
Inthepreviousrelease,IPPrintWayprovidedcopiessupportonlyforasmallsubsetofprinterswhoseLPDssupportprintingthesamedatasetmultipletimes.
Also,theadministratorcannowlimitthenumberofcopiesthatareallowedtoprintoneachprinter.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcancontrolhowIPPrintWayprintscopies.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
InterfacesSeeTable20onpage124andTable24onpage130.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationBydefault,thisnewcopysupportisenabled.
YoucandisablethissupporttoimproveperformanceforaprinterwhoseLPDsupportsprintingmultiplecopiesofthesamedataset.
Todothis,selecttheOptimizecopiesfieldintheprinterdefinition.
Optionalz/OSInfoprintServerOperationandAdministrationIfyouwanttolimitthenumberofcopies,specifythemaximumnumberofcopiesintheMaximumcopiesfieldintheprinterdefinition.
Optionalz/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertoz/OSInfoprintServerOperationandAdministration.
IPPrintWayCopySupportChapter3.
z/OSVersion1Release2Overview17|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||IPPrintWayE-mailSupportDescriptionTheIPPrintWaycomponentofInfoprintServernowletsyousendoutputfromtheJESspooltooneormoree-mailaddresses.
Previously,IPPrintWaycouldtransmitoutputonlytoprintersandprintservers.
ThissupportletsyoueasilydistributedocumentsovertheInternetandletse-mailrecipientsviewtheoutputandprintitonlywhennecessary.
Somefeaturesofthee-mailsupportare:vIPPrintWayusesthez/OSUNIXsendmailfunctionofz/OSCommunicationsServer.
vIPPrintWaysendseachdocumentasane-mailattachment.
vDatacanbeinanyformat,includingPDF,PostScript,AFP,andtextformat.
vYoucantransformprintdatatoanotherformatthatissuitableforviewingonaworkstation,asfollows:–TransformtraditionallinedataandVTAMapplicationdata(forexample,CICSandIMSdata)totextformat.
–Transformtraditionallinedata,VTAMapplicationdata,andAFPdatatoPDForPostScriptformat.
–TransformPCLdata,SAPOTFdata,PostScriptData,andVTAMapplicationdatatoAFPformat.
vWhenyouprintVTAMapplicationdata,youcansendoutputtoane-mailaddresslistandprintitatthesametime.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationCreateprinterdefinitionsinthePrinterInventoryforeache-mailaddressoraddresslist.
Createprinterpooldefinitionstoprintande-mailVTAMapplicationdata.
Handlebouncede-mailsandreplies.
Createsendmailaliases.
ApplicationDevelopmentNone.
AuditingIPPrintWaywritesanSMFtype-6recordforeache-mailitsends.
CustomizationCustomizesendmailandothercomponentsofz/OSCommunicationsServerthatsendmailrequires.
Customizeanytransformsyouwanttouse,suchastheAFPtoPDFtransform.
Ifyoutransformdata,specifynoblanktruncationforJESoutputclasses.
IfsendmailandInfoprintServerfilesarenotindefaultlocations,specifyenvironmentvariablesintheIPPrintWaystartupprocedure.
DiagnosisDiagnosepossiblesetupproblemswithsendmail.
GeneralUserSpecifythee-mailtitleandattachmentnameinJCLparametersandjobattributesifthedefaultvaluesarenotsuitable.
TosendAFPfilesthatuseexternalAFPresources,usetheIBMACIFprogramtocreateafilewithAFPresources.
Toviewe-mailattachmentsthatarenotintextformat,downloadandcustomizeaviewer.
OperationsStartsendmail.
InterfacesSee"EnvironmentVariables"onpage113,"InfoprintServerISPFPanels"onpage124,and"PIDUPrinterAttributes"onpage130.
IPPrintWayE-mail18z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||||||||||||||||||||||||||||||||||||||||||DependenciesApplyInfoprintServerPTFsUW85327andUW85325toobtainthisenhancementinz/OSV1R2andlaterreleases.
TotransformdatatoPDF,PostScript,orAFPformat,oneofthefollowingfeaturesofInfoprintServerTransforms(5697–F51)isrequired:vTransformstoAFPfeaturetotransformPCL,PostScript,andPDFdatatoAFPformat.
ThisfeatureisavailableatnoextrachargetoInfoprintServercustomers.
vAFPtoPDFfeaturetotransformlineandAFPdatatoPDFformat.
Thisfeatureispricedseparately.
vAFPtoPostScriptfeaturetotransformlineandAFPdatatoPostScriptformat.
Thisfeatureispricedseparately.
IfyouusetheAFPtoPDFtransform,outlinefontsarerecommended.
TheIBMACIFprogram,anoptionalfeatureofPSFforOS/390(5655–B17),isrequiredtocaptureexternalAFPresourcessothattheycanbeincludedinAFPfilessentase-mailattachments.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationCustomizez/OSUNIXsendmailandothercomponentsofz/OSCommunicationsServerrequiredbysendmail.
Requiredz/OSInfoprintServerCustomization,SendmailbyO'Reilly&Associates,Inc.
Customizedatastreamtransforms,suchastheAFPtoPDFtransform,ifyouwantthee-mailattachmenttobeinanotherformat,suchasinPDFformat.
IntheconfigurationfileentryfortheAFPtoPDFtransformorintheprinterdefinition,specifyAFPresourcelibrariesandadefaultfont.
Inthetransformconfigurationfile,requestthatthetransformmaprasterfontstooutlinefontsbecauseoutlinefontsprovidesuperiorviewing.
Optionalz/OSInfoprintServerCustomizationIntheJES2OUTCLASSstatementsorJES3SYSOUTstatements,specifynoblanktruncationforallJESoutputclassesspecifiedintheprinterdefinitions.
Requiredz/OSInfoprintServerCustomizationSpecifyenvironmentvariablesintheIPPrintWaystartupprocedureifyoudidnotinstallz/OSUNIXsendmailandInfoprintServerfilesinthedefaultdirectories.
RestartIPPrintWaytopickupthechanges.
Optionalz/OSInfoprintServerCustomizationIPPrintWayE-mailChapter3.
z/OSVersion1Release2Overview19|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||TaskConditionReferenceInformationWriteormodifyIPPrintWayexitsifyouwanttodynamicallymodifye-mailprocessing.
TheRouting,BeginDataSet,EndDataSet,andRecordexitscandetectthatthee-mailprotocolisselected.
Youmightwanttowriteormodifytheseexitsforthee-mailprotocol:vRoutingexit:Youcanmodifye-mailaddressesandtransmissionoptions.
vBeginDataSetandEndDataSetexits:Youcansuppressanyseparatorpagesandprinterinstructionsthattheseexitsadd.
Youdonotneedtorecompileexistingexits.
Optionalz/OSInfoprintServerCustomizationCreateaprinterdefinitioninthePrinterInventoryforeache-mailaddressoraddresslist.
Intheprinterdefinition,selectthee-mailprotocol,specifythee-mailaddressesoftherecipients,andspecifyotherfieldsusedforthee-mailprotocol.
Requiredz/OSInfoprintServerOperationandAdministrationIntheprinterdefinition,specifyadata-streamtransformandthefieldsusedforthetransform.
Suggestedtransformsare:vAFPtoPDFtransformvPCLtoAFPtransformOptionalz/OSInfoprintServerOperationandAdministrationCreateaprinterpooldefinitioninthePrinterInventoryifyouwanttoe-mailandprintVTAMapplicationdata(suchasCICSandIMSdata)atthesametime.
Optionalz/OSInfoprintServerOperationandAdministrationCreateaz/OSUNIXsendmailaliasnameforanye-mailaddresslistthatisgreaterthan256characters.
Specifythealiasnameintheprinterdefinition.
Optionalz/OSInfoprintServerOperationandAdministration,SendmailbyO'Reilly&Associates,Inc.
Startsendmail.
Requiredz/OSInfoprintServerOperationandAdministrationHandlebouncede-mailsandreplies.
Requiredz/OSInfoprintServerOperationandAdministration,SendmailbyO'Reilly&Associates,Inc.
Specifythesubjectofthee-mailintheTITLEJCLparameterandthee-mailattachmentnameintheDSNAMEJCLparameterifthedefaultvaluesarenotsuitable.
Optionalz/OSInfoprintServerUser'sGuideSpecifythesubjectofthee-mailintheInfoprintServertitle-textjobattributeifthedefaultvalueisnotsuitable.
Optionalz/OSInfoprintServerUser'sGuideUsetheIBMACIFprogramtocreateaseparatefilewithAFPresourcesifyouwanttoe-mailanAFPfilethatusesexternalAFPresources.
ACIFcreatesaseparateAFPresourcefilethatyoumustconcatenatetoyourdocumentwhenyousubmittheprintjob.
ACIFisnotrequiredifyouusetheAFPtoPDFtransformtotransformlineandAFPfilestoPDFformat.
Optionalz/OSInfoprintServerUser'sGuideIPPrintWayE-mail20z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||TaskConditionReferenceInformationDownloadaviewertoyourworkstationtoviewe-mailattachmentsthatarenotintextformat.
Suggestedviewersare:vAdobeAcrobatReaderforPDFfilesvIBMAPFViewerforWindowsforAFPfilesvGhostviewforPostScriptfilesWerecommendusingthelatestvieweravailable.
AdditionalcustomizationmightberequiredfortheAdobeAcrobatReader.
Optionalz/OSInfoprintServerUser'sGuideForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerOperationandAdministrationvz/OSInfoprintServerUser'sGuidevSendmailbyO'Reilly&Associates,Inc.
(ISBN1–56592–222–0)IPPrintWayE-mailChapter3.
z/OSVersion1Release2Overview21|||||||||||||||||||||||IPPrintWayExitEnhancementDescriptionTheIPPrintWaycomponentofInfoprintServerhasenhancedhowexitsworkwiththeDocumentheaderandDocumenttrailerfieldsintheprinterdefinition:vPrinterinstructionsspecifiedintheDocumentheaderfieldnolongerapplytodataaddedbytheIPPrintWayBeginDataSetexit.
vPrinterinstructionsspecifiedintheDocumenttrailerfieldnowapplytodataaddedbytheIPPrintWayEndDataSetexit.
Forexample,if(1)theDocumentheaderfieldcontainsprinterinstructionsforlandscapeprinting,(2)theDocumenttrailerfieldcontainsprinterinstructionstoresettheprintertoportraitorientation,and(3)theIPPrintWayBeginDataSetexitandEndDataSetexitaddaseparatorpage,nowtheseparatorpageswillprintintheportraitorientation.
Ifyouwanttheseparatorpagestoprintinthelandscapeorientation,youmustaddprinterinstructionsforlandscapeprintinginyourBeginDataSetexitandEndDataSetexit.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationThesystemprogrammermightneedtomodifyIPPrintWayexits.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
InterfacesSeeTable15onpage113.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationReviewyourIPPrintWayBeginDataSetandEndDataSetexitstodetermineifthischangeaffectsyourexits.
ReviewexitsonlyifyouspecifytheDocumentheaderorDocumenttrailerfieldsinyourprinterdefinitions.
Optionalz/OSInfoprintServerCustomizationForMoreInformationFormoredetailedinformationaboutthissupport,refertoz/OSInfoprintServerCustomization.
IPPrintWayExitEnhancement22z/OSV1R2.
0InfoprintServerMigration|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||IPPrintWayEnhancementsforPrintingtoVTAMPrintersDescriptionIPPrintWaynowprovidesenhancedsupportforprintingtoVTAM-controlledprinters:vTheadministratorcanrequestthatIPPrintWaytransmitoutputdatasetsfromtheJESspooltoVTAM-controlledprinterswithoutconvertingthedatatoSNACharacterString(SCS)orDataStreamCompatible/DataStreamExtended(DSC/DSE)format.
ThissupportmeansthatyoucannowprintdatathatisalreadyintheformatrequiredbyyourVTAM-controlledprinters.
Forexample,youcanprintPCLdatatoVTAM-controlledprintersthatacceptPCLdata.
Optionally,IPPrintWaycantransmittheunchangeddatatotheVTAM-controlledprinterastransparentdata.
ThissupportletsyoutransmitdatathroughanSNAgatewaythatrequiresthatdatabeprecededbytransparentdatacontrols.
Typically,theSNAgatewayremovesthetransparentdatacontrolsbeforetransmittingthedatatotheprinter.
Foreachprinter,theadministratorcanspecifythetransparentdatacharacterthattheSNAgatewayexpectsinthetransparentdatacontrols.
vTheadministratorcanchangetheend-of-linecontrolsthatIPPrintWayaddstotheendofeachline.
ThissupportisavailableonlywhenIPPrintWayconvertslinedatatoSCSorDSC/DSEformat.
vTheadministratorcanrequestthatIPPrintWaydeleteform-feedcontrolsthatresultinblankpagesatthebeginningandendofdocuments.
ThissupportisavailablewhenIPPrintWayconvertslinedatatoSCSorDSC/DSEformat.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationCreateanIPPrintWayprinterdefinitioninthePrinterInventoryfortheVTAMprotocol.
Selectoptionsforprintingbinarydata;specifyalineterminationvalue;selectthedeleteformfeedoption.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisGeneralUserNone.
OperationsNone.
InterfacesSee"InfoprintServerISPFPanels"onpage124and"PIDUPrinterAttributes"onpage130.
DependenciesApplythefollowingPTFstoobtainthisenhancementinz/OSV1R2andlaterreleases:vToprintdataunchangedtoVTAM-controlledprinters:–InfoprintServerPTFsUW82899andUW82940–InfoprintServerTransformsPTFUW82927vTochangetheend-of-linecontrol:IPPrintWayEnhancementsforPrintingtoVTAMPrintersChapter3.
z/OSVersion1Release2Overview23|||||||||||||||||||||||||||||||||||||||||||||||||||||||||–InfoprintServerPTFsUW82899andUW82940vTodeleteform-feedcontrols:–InfoprintServerPTFUW85178–InfoprintServerTransformsPTFUW85179MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationCreateaprinterdefinitionforeachVTAM-controlledprinter.
Intheprinterdefinition,selectthefollowingoptions:vNoneoptionintheFormattingfieldontheIPPrintWayOptionspanel.
vSendastransparentdatafieldontheVTAMProtocolpanel.
Also,specifythetransparentdatacontrolcharacterintheTransparentdatacharfield;thedefaultvalueisX'35'.
Requiredz/OSInfoprintServerOperationandAdministrationIntheprinterdefinitionforaVTAM-controlledprinter,specifytheline-terminationvalueintheLineterminationfieldontheIPPrintWayOptionspanel;thedefaultvalueisX'0D15'.
Requiredz/OSInfoprintServerOperationandAdministrationIntheprinterdefinitionforaVTAM-controlledprinter,selectthetypeofformfeedstodeleteintheFormfeedfieldontheIPPrintWayOptionspanel.
Youcandeleteformfeedsatthebeginningandendofdatasets.
Requiredz/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertoz/OSInfoprintServerOperationandAdministration.
IPPrintWayEnhancementsforPrintingtoVTAMPrinters24z/OSV1R2.
0InfoprintServerMigration|||||||||||||||||||||||||||||||||||||||||||||||||IPPrintWayQueryPrinterStatusDescriptionTheIPPrintWaycomponentofInfoprintServernowletstheoperatorquerythestatusoftheprinterfromtheInfoprintServerISPFpanels.
Theoperatorwillfindthisfunctionusefulwhentransmissionofadatasettotheprinterisunsuccessful.
ThisfunctionisavailableonlywhenIPPrintWayusestheLPRtoLPDtransmissionprotocoltotransmitadatasettotheprinter.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserNone.
OperationsTheoperatorcanquerythestatusofaprinterfromInfoprintServerISPFpanels.
InterfacesSeeTable20onpage124.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationUsetheInfoprintServerISPFpanelstoviewtheIPPrintWaytransmissionqueue,andenterSorLintheActioncolumninfrontofaqueueentry.
Requiredz/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertoz/OSInfoprintServerOperationandAdministration.
IPPrintWayQueryPrinterStatusChapter3.
z/OSVersion1Release2Overview25||||||||||||||||||||||||||||||||||||||||||||||||||||||IPPrintWayResubmitforFilteringEnhancementsDescriptionWhenyouusetheIPPrintWayresubmitforfilteringfunctiontotransformdata,PrintInterfaceallocatesasecondsysoutdatasetontheJESspoolforeachoriginalsysoutdataset;thesecondsysoutdatasetcontainsthetransformeddata.
Beforetheseenhancementstotheresubmitforfilteringfunction:vThejobIDandjobnameofthesecondsysoutdatasetontheJESspoolwerenotthesameasthejobIDandjobnameoftheoriginalsysoutdataset.
Therefore,theoperatorcouldnotfindthesecondsysoutdatasetontheJESspool.
vTheIDoftheuserwhostartedtheInfoprintServerLPDprintedastheowneronseparatorpages,wasrecordedastheownerintheSMFtype6recordforthesecondsysoutdataset,andwaspassedasinputtoIPPrintWayexitroutines.
Withtheseenhancementstotheresubmitforfilteringfunction:vThejobIDandjobnameofthesecondsysoutdatasetontheJESspoolarethesameasthejobIDandjobnameoftheoriginalsysoutdataset.
vTheIDofthejobsubmitterprintsonseparatorpages,isrecordedastheownerintheSMFtype6recordsforboththefirstandsecondsysoutdatasets,andispassedasinputtoIPPrintWayexitroutines.
ThefollowingtablesummarizesthecontentsofSDSFfieldsforthesecondsysoutdatasetontheJESspool.
Forcomparison,thetablealsosummarizesthecontentsbeforethisenhancement.
DataSetFieldonJESSpool1ContentsContentsBeforeThisEnhancementJobIDJobIDassignedbyz/OStotheoriginalsysoutdataset2JobIDassignedbyInfoprintServertothesecondsysoutdatasetJobnameJobnameoftheoriginalsysoutdatasetUserIDofthejobsubmitterOwnerUserIDoftheuserwhostartedtheInfoprintServerLPDUserIDoftheuserwhostartedtheInfoprintServerLPD1.
ThisistheSDSFfieldname.
2.
ThejobIDthatispartofthefully-qualifieddatasetnameisauniqueIDthatz/OSassignstothesecondsysoutdataset.
ThejobIDdisplayedinthelpstatcommandisauniqueIDthatInfoprintServerassignstothesecondsysoutdataset.
ThefollowingtablesummarizesthecontentsoftheSMFtype6recordthatIPPrintWaywritesforthesecondsysoutdataset.
Forcomparison,thetablealsosummarizesthecontentsbeforethisenhancement.
SMFType6FieldContentsContentsBeforeThisEnhancementSMF6JBNJobnameoftheoriginalsysoutdatasetUserIDofthejobsubmitterSMF6USIDUserIDofthejobsubmitterUserIDoftheuserwhostartedtheInfoprintServerLPDIPPrintWayResubmitforFilteringEnhancements26z/OSV1R2.
0InfoprintServerMigration|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||ThefollowingtablesummarizesthecontentsoftheXTPUSRIDfield,whichisinputtoIPPrintWayexitroutines.
Forcomparison,thetablealsosummarizesthecontentsofthisfieldbeforethisenhancement.
FieldinANFUEXTPControlBlockContentsContentsBeforeThisEnhancementXTPUSRIDUserIDofthejobsubmitterUserIDoftheuserwhostartedtheInfoprintServerLPDWhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingModifyaccountingroutinesifnecessarytousechangedvalues.
CustomizationModifyIPPrintWayexitroutinesifnecessarytouseuserIDofjobsubmitter.
DiagnosisNone.
GeneralUserNone.
OperationsTheoperatorcannowusethejobnameorjobIDtofindthesecondsysoutdatasetontheJESspool.
InterfacesSee"Exits"onpage113and"SMFType6Record"onpage132.
DependenciesApplyInfoprintServerPTFUW87646toobtainthisenhancementinz/OSV1R2andlaterreleases.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationReviewaccountingroutinesthatexamineSMFtype6recordstoseeifchangestofieldsSMF6JBID,SMF6JBN,andSMF6USIDaffectthem.
Optionalz/OSInfoprintServerOperationandAdministrationReviewIPPrintWayexitroutinestoseeifthechangetofieldXTPUSRIDaffectsthem.
Optionalz/OSInfoprintServerCustomizationIPPrintWayResubmitforFilteringEnhancementsChapter3.
z/OSVersion1Release2Overview27|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||ForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerOperationandAdministrationIPPrintWayResubmitforFilteringEnhancements28z/OSV1R2.
0InfoprintServerMigration|||||IPPrintWayTCP/IPConnectionTimeoutEnhancementDescriptionIPPrintWaynowwaitsamaximumof30secondsforTCP/IPtoconnecttoaprinter.
Priortothisenhancement,IPPrintWaywaitedupto3minutes.
BecausetheIPPrintWayFSAcannotprocessorprintanyotherdatasetswhileitwaitsforTCP/IPtoconnecttotheprinter,thisenhancementcansignificantlyimproveperformance.
YoucanchangetheTCP/IPconnectiontimeoutvalueforeachprinterinthenewConnectiontimeoutfieldintheIPPrintWayOptionssectionoftheprinterdefinition.
Youcanspecifyavaluefrom5to180seconds;thedefaultvalueis30seconds.
IfyouusethePrinterInventoryDefinitionUtility(PIDU)toeditprinterdefinitions,youcanspecifythenewconnection-timeoutattributetochangethetimeoutvalue.
ThisenhancementappliesonlywhenIPPrintWayusestheTCP/IPLPRordirectsocketsprintingprotocoltocommunicatewiththeprinter.
ItdoesnotapplytoVTAM-controlledorIPP-enabledprinters.
And,itdoesnotapplywhenIPPrintWaysendsdatatoane-maildestinationinsteadoftoaprinter.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationChangethevalueintheConnectiontimeoutfieldofprinterdefinitionsifdesired.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
InterfacesSee"InfoprintServerISPFPanels"onpage124and"PIDUPrinterAttributes"onpage130.
DependenciesApplyInfoprintServerPTFUW88108toobtainthisenhancementinz/OSV1R2andlaterreleases.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
IPPrintWayTCP/IPConnectionTimeoutChapter3.
z/OSVersion1Release2Overview29||||||||||||||||||||||||||||||||||||||||||||||||||TaskConditionReferenceInformationChangethevalueintheConnectiontimeoutfieldoftheprinterdefinitionifthedefaultvalueof30secondsisnotsuitable.
Optionalz/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertoz/OSInfoprintServerOperationandAdministration.
IPPrintWayTCP/IPConnectionTimeout30z/OSV1R2.
0InfoprintServerMigration|||||||||||||||||NetSpoolExitEnhancementsDescriptionTheNetSpoolcomponentofInfoprintServernowprovidestwonewexits:vTheGraphicEscapeexit(APIUGEX)forSCSand3270datastreams.
Yoursystemprogrammercanusethisexittomapgraphicescapesequencestoappropriateprintablecharactersinanalternatefont.
Forexample,aGraphicEscape″T″canbemappedtoatelephonesymbolintheWingdingsfont.
AsampleGraphicEscapeexit(APIJUGEX)providedinSYS1.
SAMPLIBshowshowtocodethenewexit.
vTheBeginningofFileexit(APIUBF3)for3270datastreams.
YoursystemprogrammercanusethisexittoaddPCLcommandstothebeginningofPCLdatastreams.
Forexample,yoursystemprogrammercanaddPCLcommandstoselectafont.
AsampleBeginningofFileexit(APIJUBF3)providedinSYS1.
SAMPLIBshowshowtocodethenewexit.
Also,NetSpoolhasenhancedtwoexistingexitsandsampleexitsforSCSdatastreams:vNetSpoolnowpassestotheTransparentDataControlexit(APIPPTD2)andBeginningofFileexit(APIPPTD1)thetypeofLUsessionandthetypeofoutputdatastream(lineorPCLdatastream).
Therefore,yourexitscannowperformdifferentfunctionsfordifferenttypesofsessionsandoutputdatastreams.
vThesampleTransparentDataControlexit(APIJPTD2)andBeginningofFileexit(APIJPTD1)nowprovideadditionalexamples,forexample,howtodeleteandmodifytransparentdatadependingonwhethertheoutputdatastreamisalineorPCLdatastream.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationOptionally,codetwonewexitsandmodifyexistingTransparentDataControlandBeginningofFileexitstoperformdifferentfunctionsdependingonthetypeofLUsessionandoutputdatastream.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
InterfacesSeeTable15onpage113andTable33onpage136.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
NetSpoolExitsChapter3.
z/OSVersion1Release2Overview31||||||||||||||||||||||||||||||||||||||||||||||||||||||||TaskConditionReferenceInformationWriteaGraphicEscapeexitifyourapplicationscontainGraphicEscapecharactercodes(X'08')thatdonotprintcorrectly.
Optionalz/OSInfoprintServerCustomizationWritea3270BeginningofFileexitifyouneedtospecifyPCLcommands(orotherdata)atthebeginningofeachoutputdatastream.
Asanalternative,youcancontinuetospecifyPCLcommandsintheDocumentheaderfieldoftheprinterdefinition.
Optionalz/OSInfoprintServerCustomizationModifyexistingTransparentDataControlandBeginningofFileexitsforSCSdatastreamstoperformdifferentfunctionsdependingonthetypeofLUsessionandtypeofoutputdatastream(lineorPCLdatastream).
Noexitchangesarerequiredexcepttotakeadvantageofnewfunction.
Optionalz/OSInfoprintServerCustomizationForMoreInformationFormoredetailedinformationaboutthissupport,refertoz/OSInfoprintServerCustomization.
NetSpoolExits32z/OSV1R2.
0InfoprintServerMigration|||||||||||||||||||||||||||||||||NetSpoolPCLConversionDescriptionTheNetSpoolcomponentofInfoprintServerhasenhanceditssupportforprintingdatafromVTAMapplications,suchasCICSandIMS.
NetSpoolcannowconvertVTAMapplicationprintdatadirectlytoPCLformat.
ThisnewsupportprovidesgreaterprintfidelityonprintersthatacceptthePCLdataformat,whichincludemostIBM,HP,Lexmark,andothermanufacturers'networkprinters.
Inpreviousreleases,NetSpoolalwaysconvertedVTAMapplicationprintdatastreams,either3270orSNACharacterSet(SCS)datastreams,tolinedata.
IPPrintWaycan,inturn,convertlinedatatotextdataforprintingonanyprinterthatacceptstextdata.
Duetolimitationsinlinedata,however,NetSpoolcouldnotpreserveallprint-formattingcontrolsintheinputdatastreams;therefore,datadidnotalwaysprintasintended.
WhenconvertingtoPCL,NetSpoolcannowpreserveadditionalprint-formattingcontrolsinSCSdatastreamsbygeneratingcorrespondingPCLcommands;thisresultsingreaterprintfidelity.
Forexample,whenconvertingSCSdata,InfoprintServercannow:vPreserveline-densityandprint-densitycontrolsvPreservepaper-source,output-bin,job-separation,andduplexrequestsvPreserveportraitandlandscapepageorientationvAutomaticallychangethepageorientationandreduceprintoutputonapage–by-pagebasisTheprintadministratorcanuseInfoprintServerISPFpanelstoeasilycustomizethisnew3270andSCStoPCLconversionfunction,onaprinter-by-printerbasis.
Forexample,theadministratorcanspecifywhethertheoutputistoprintintheportraitorlandscapepageorientation.
Limitation:NetSpooldoesnotsupportTCP/IPtranslationtablesoruseDBCScodepageswhenitconvertsEBCDICdatatoASCIIPCLdatastreams.
CustomerswhoneedtousecustomizedTCP/IPconversiontablesandDBCSapplicationsshouldnotenablethisnewfunction.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationModifytheprinterdefinitionstorequestthatNetSpoolconvertdatastreamstoPCLformatandspecifyfieldsthatcontrolhowNetSpoolconvertsdatastreams.
ApplicationDevelopmentModifyVTAMapplicationstoaddSCScontrols,suchasthePagePresentationMedium(PPM)control.
AuditingNone.
NetSpoolPCLConversionChapter3.
z/OSVersion1Release2Overview33||||||||||||||||||||||||||||||||||||||||||||||AreaConsiderationsCustomizationvEnsurethattheuserIDthatstartsNetSpoolisaz/OSUNIXuser.
vSpecifynoblanktruncationfortheJESoutputclassesinwhichNetSpoolcanallocatedatasets.
vSpecifyLEandC++run-timelibrariesintheNetSpoolstartupprocedure;modifyLErun-timeoptions.
vChangedefaultEBCDICandASCIIcodepagesintheInfoprintServerconfigurationfile.
vAddPCLcontrolsintheBeginningofFileexitfor3270datastreams;modifyexistingTransparentDataControlandBeginningofFileforSCSexitstoperformdifferentfunctionsdependingonthetypeofLUsessionandoutputdatastream.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
InterfacesSeeTable20onpage124,Table31onpage135,Table24onpage130,andTable27onpage133.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatwanttoenablethisfunction.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionProcedureReferenceRequestPCLconversionintheprinterdefinitionsinthePrinterInventory.
SelecttheConverttoPCLoptionintheFormattingfield.
Requiredz/OSInfoprintServerOperationandAdministrationEditthenewPCLconversionfieldsintheprinterdefinitionsifdefaultvaluesarenotsuitable:vLinedensityfieldvOrientationfieldvPrintdensityfieldvSCSautomaticpageorientationfieldOptionalz/OSInfoprintServerOperationandAdministrationEnsurethattheuserIDthatstartsNetSpoolisaz/OSUNIXuser.
TheuserIDmusthaveanOMVSsegmentandahomedirectory.
Required1z/OSInfoprintServerCustomizationAddtheCEE.
SCEERUNandCBC.
SCLBDLLdatasetstotheNetSpoolstartupproceduresiftheLEandC++run-timelibrariesarenotinthesystemLNKLST,andrestartNetSpool.
ThistaskisrequiredbecauseNetSpoolnowrunsintheLanguageEnvironment(LE).
Optionalz/OSInfoprintServerCustomizationChangedefaultLErun-timeoptionsifdefaultoptionsarenotsuitableforyourinstallation.
Optionalz/OSInfoprintServerCustomizationIntheJES2OUTCLASSstatementsorJES3SYSOUTstatements,specifynoblanktruncationfortheoutputclassesinwhichNetSpoolcanallocatedatasets.
Requiredz/OSInfoprintServerCustomizationNetSpoolPCLConversion34z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||TaskConditionProcedureReferenceChangedefaultEBCDICandASCIIcodepagesintheInfoprintServerconfigurationfile,aopd.
conf,ifthedefaultvaluesarenotsuitablebecauseNetSpoolnowconvertsEBCDICdatatoASCIIrepresentation.
Optionalz/OSInfoprintServerCustomizationModifyNetSpoolexitstoperformdifferentprocessingfordifferenttypesofVTAMsessionsortypesofoutputdatastreams(linedataorPCLdata).
Noexitchangesarerequiredexcepttotakeadvantageofnewfunction.
Optionalz/OSInfoprintServerCustomizationUnderstandhowNetSpoolconvertsdatatoPCLformat.
AddSCScontrolstoVTAMapplicationprintoutput,suchasthePresentationPageMedium(PPM)control,totakefulladvantageofthisnewfunction.
Optionalz/OSInfoprintServerUser'sGuide1.
Thistaskisrequiredbyallinstallations,whetherornottheinstallationenablesthenewfunction.
ForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerOperationandAdministrationvz/OSInfoprintServerUser'sGuideNetSpoolPCLConversionChapter3.
z/OSVersion1Release2Overview35||||||||||||||||||||||||||||||||||||||PrintInterface>255CopiesSupportDescriptionThePrintInterfacecomponentofInfoprintServernowletsthejobsubmitterrequestupto32640copiesofthesamedocumentinthecopiesjobattribute.
ThisfunctioncanbeusedbyanyjobsubmitterwhocanspecifyInfoprintServerjobattributes.
Inpreviousreleases,themaximumnumberofcopiesthatcouldbespecifiedwas255.
Also,theadministratornowcanspecify32640copiesinthecopiesfieldoftheprinterdefinitionforprintrequestssubmittedthroughPrintInterface.
IftheprinterdefinitionissharedwithNetSpool,andavaluelargerthan255isspecified,NetSpooluses255.
Theadministratorcanalsospecifyupto32640copiesintheMaximumcopiesfieldoftheprinterdefinitiontolimitthenumberofcopiesprinted.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcanrequestupto32640copiesintheprinterdefinition,butonlyforprintrequestssubmittedthroughPrintInterface.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserThejobsubmittercanrequestupto32640copiesinajobattribute.
OperationsNone.
InterfacesSeeTable20onpage124,Table23onpage128,andTable24onpage130.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationSpecifytheCopiesfieldintheprinterdefinition,orspecifythecopiesjobattributeatjobsubmission.
Requiredz/OSInfoprintServerOperationandAdministration,z/OSInfoprintServerUser'sGuideForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerOperationandAdministrationvz/OSInfoprintServerUser'sGuidePrintInterface>255CopiesSupport36z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||PrintInterfaceInfoprintPortMonitorforWindowsEnhancementsDescriptionTheInfoprintPortMonitorforWindowsVersion2.
0containsthefollowingenhancements:vTheInfoprintPortMonitorrunsonWindowsMillenniumEdition(Me)andWindowsXPsystems,aswellasonWindows95/98,WindowsNT,andWindows2000systems.
vTheInfoprintPortMonitorprocessesdatamoreefficientlybecauseitnolongerwritestemporaryfilesontheWindowssystem.
vOnWindowsNT,Windows2000,andWindowsXPsystems,InfoprintPortMonitorerrorsarepermanentlyrecordedintheWindowsEventLog.
vThenewUnattendedportoptionindicatesthataprinteratanInfoprintportisusedbyWindowsusersonothersystems.
Whenyouselectthisoption,theInfoprintPortMonitordoesnotdisplayerrormessagesthatrequirearesponsebeforeotherdocumentscanbeprinted.
vWhenyouinstallthenewversionoftheInfoprintPortMonitor,youdonotneedtofirstuninstallthedown-levelInfoprintPortMonitor.
TheinstallprocesspreservesexistingWindowsprintersandInfoprintportconfigurations,whileautomaticallyupgradingtheInfoprintPortMonitor.
vOnWindowsNTandWindows2000systems,theInfoprintPortMonitorinstallprocessnolongerpredefinesoneInfoprintport.
Therefore,theWindowsusershouldfollowinstructionsintheWindowsAddPrinterwizardtoaddanInfoprintport.
vAdditionalhelpinformationisincorporatedintheInfoprintPortMonitor.
Therefore,theInfoprintPortMonitorReadmefileisnolongerprovided.
vTouninstallthenewInfoprintPortMonitor,youcannowusethestandardWindowsuninstallprocess.
vOnWindows2000andWindowsXPsystems,theWindowsAdd/RemoveProgramsdialogboxnowdisplaystheversionoftheInfoprintPortMonitorthatisinstalled.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationIfyouhavedefinedWindowssharedprinters,selectthenewUnattendedportoption.
DiagnosisUseadditionalerrorinformationintheWindowsEventLogonWindowsNT,Windows2000,andWindowsXPsystems.
GeneralUserTousethenewInfoprintPortMonitor,theWindowsusermustdownloadandinstallit.
OperationsNone.
InterfacesSee"InfoprintPortMonitorforWindows"onpage124.
InfoprintPortMonitorforWindowsChapter3.
z/OSVersion1Release2Overview37|||||||||||||||||||||||||||||||||||||||||||||||||||||||||DependenciesApplyInfoprintServerPTFsUW86129andUW87698toobtainthisenhancementinz/OSV1R2andlaterreleases.
ThenewInfoprintPortMonitorhasthefollowingadditionalsoftwarerequirements:vWindows95systems:TheWindowsSocket2updateisrequired.
YoucandownloadtheupdatefromtheMicrosoftWebsiteat:http://www.
microsoft.
com/windows95/downloads/contents/wuadmintools/s_wunetworkingtools/w95sockets2/vWindowsNTsystems:Version4.
0orhigherisrequired.
vMicrosoftInternetExplorer3.
x(orlater)isrequiredinordertoviewInfoprintPortMonitoronlinehelp.
YoucandownloadtheInternetExplorerfromtheMicrosoftWebsiteat:http://www.
microsoft.
com/ie/vIfInfoprintManagerSelectisinstalledontheWindowssystem,InfoprintManagerSelectshouldbeatthelatestlevel.
WindowsuserscancontinuetousethepreviousversionoftheInfoprintPortMonitorforWindowsiftheydonotwanttousetheenhancementsoriftheywanttousetheJapanesetranslation.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationDownloadandinstallthenewInfoprintPortMonitor.
DonotfirstuninstallthepreviousversionoftheInfoprintPortMonitor.
RequiredInfoprintPortMonitoronlinehelp;z/OSInfoprintServerUser'sGuideReconfigureInfoprintportsforWindowssharedprinterstoselecttheUnattendedportoption.
OptionalInfoprintPortMonitoronlinehelp;z/OSInfoprintServerUser'sGuideOnWindowsNT,2000,andXPsystems,viewerrorinformationintheWindowsEventLog.
OptionalInfoprintPortMonitoronlinehelpForMoreInformationFormoredetailedinformationaboutthissupport,referto:vOnlinehelpprovidedwithInfoprintPortMonitor.
vz/OSInfoprintServerCustomizationvz/OSInfoprintServerUser'sGuideInfoprintPortMonitorforWindows38z/OSV1R2.
0InfoprintServerMigration|||||||||||||||||||||||||||||||||||||||||||||||||||||PrintInterfaceIPPServerJavaSupportDescriptionThePrintInterfaceInternetPrintingProtocol(IPP)servernowrequiresJava1.
3.
ItnolongersupportsJava1.
1.
8.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationThesystemprogrammermustinstallJava1.
3,authorizetheJavarun-timelibraries,andincreasethemaximumregionsize.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
InterfacesNoneMigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
RequiredtasksapplytoallinstallationsthatusetheIPPServer.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationEnsurethatyourinstallationrunsJava1.
3andthattheJava1.
3librariesareAPF-authorized.
YoucanruntheAOPJAUTHprogramtoauthorizetheJava1.
3libraries.
IfyoudidnotinstallJava1.
3inthedefaultdirectories,specifytheJavadirectoryintheJAVA_HOMEenvironmentvariableinthenewaopstartEXEC.
Alsoincreasethemaximumregionsizeto100megabytes(MB).
DependingonhowyoustarttheIPPserver,changetheregionsizeintheAOPSTARTcommand,intheBPXPRMxxmemberofSYS1.
PARMLIB,orontheTSO/Elogonpanel.
Requiredz/OSInfoprintServerCustomizationForMoreInformationFormoredetailedinformationaboutthissupport,refertoz/OSInfoprintServerCustomization.
PrintInterfaceIPPServerJavaSupportChapter3.
z/OSVersion1Release2Overview39||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||PrintInterfaceRemoteTransformSupportforIBMInfoprintColor130PlusPrinterDescriptionThePrintInterfacecomponentofInfoprintServernowletsyouusethePostScriptandPDFtoAFPcolortransformprovidedbyInfoprintManagerforAIX.
ThisAIXtransformisrequiredtoprintcolorPostScriptandcolorPDFfilesontheIBMInfoprintColor130Plusprinter.
YoucannowspecifythefollowingnewoptionsandvaluesontheexistingPrintInterfaceremotetransformfilter,aoprform.
dll:vThe-afs45optioncausesthetransformtocreateFS45imageoutput,whichtheIBMInfoprintColor130printerrequires.
vThe-qoptionletsyouspecifythefollowingtransformattributestocustomizethecolortransform:color-profile={euroscale|none|swop}Specifiesthecolorprofilethatthetransformistouse.
color-rendering-intent={relative|perceptual}SpecifieshowthetransformistoprocessshadesthattheInfoprintColor130Pluscannotreproduceexactly.
color-toner-saver={no|yes}Specifieswhetherthetransformistoreducetheamountofcolortonerusedbytheprinter.
presentation-object-container-extraction-mode={ignore|inline}Specifieshowthetransformgeneratespresentationobjectcontainerresourcesintheoutputstream.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationSpecifytheAIXcolortransformintheprinterdefinitionforanIBMInfoprintColor130Plusprinter.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserModifycolortransformattributeswhensubmittingajob.
OperationsNone.
InterfacesSee"Filters"onpage122and"/usr/lpp/Printsrv/samples/Directory"onpage138.
DependenciesApplyInfoprintServerPTFUW85327toobtainthisenhancementinz/OSV1R2andlaterreleases.
InfoprintManagerforAIXV3R2(5785–E42)orlaterisrequired.
PrintInterfaceRemoteTransformforInfoprintColor130PlusPrinter40z/OSV1R2.
0InfoprintServerMigration|||||||||||||||||||||||||||||||||||||||||||||||||||||MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationIntheprinterdefinitionforanIBMInfoprintColor130Plusprinter,specifytheaoprform.
dllfilterwiththe-afs45optionforthePostScriptandPDFdataformats.
Optionally,specifycolortransformattributesinthe-qoption.
Requiredz/OSInfoprintServerOperationandAdministrationModifycolortransformattributesbyspecifyingthe-qattributewiththefilter-optionsattributewhenyousubmitajob.
ThisfunctionisavailableforjobsubmissionmethodsthatletyouspecifyInfoprintServerjobattributes.
Optionalz/OSInfoprintServerUser'sGuideForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingpublications:vz/OSInfoprintServerOperationandAdministrationvz/OSInfoprintServerUser'sGuidevIBMInfoprintColor130PlusInstallationPlanningGuidevIBMInfoprintManagerforAIX:Administrator'sGuidevIBMInfoprintManager:ReferencePrintInterfaceRemoteTransformforInfoprintColor130PlusPrinterChapter3.
z/OSVersion1Release2Overview41|||||||||||||||||||||||||||||||||||||PrintInterfaceSubsystemforBatchApplicationsDescriptionThePrintInterfacesubsystemprovidesenhancedsupportforbatchapplications.
BatchapplicationscannowusetheautomatictransformfunctionprovidedbyPrintInterface.
ThePrintInterfacesubsystemcanautomaticallydetectthedataformatofmostdatasetsand,usingtransformsprovidedbyInfoprintServerTransforms,transformthedatatotheformatrequiredbytheprinterore-maildestinationbeforewritingthedatatotheJESspool.
AbatchapplicationmightwanttousethePrintInterfacesubsysteminthefollowingsituations:vTotransformbatchapplicationoutputthatcontainsPCL,PostScript,orPDFdatatoAFPformatandprintitonIBMAFPprinterscontrolledbyPSFforOS/390.
vTotransformbatchapplicationoutputthatcontainslinedataorAFPdatatoPCLorPostScriptformatandprintitonPCLorPostScriptprinterscontrolledbyIPPrintWayvTotransformbatchapplicationoutputthatcontainslinedataorAFPdatatoPDFformatandsendittoe-maildestinations.
vTospecifyInfoprintServerjobattributes.
YourinstallationcanusethePrintInterfacesubsysteminsituationswhereyounowmightusetheIPPrintWayresubmitforfilteringfunction.
Thesubsystemprovidestheseadvantagesovertheresubmitforfilteringfunction:vThesubsystemismoreefficientbecauseittransformsdatabeforewritingittotheJESspool;therefore,dataiswrittentotheJESspoolonlyonetime.
vThejobsubmittercancodetheDEST=IP,PRTQUEUE,andPORTNOparametersontheOUTPUTJCLstatementtooverridetheprinter'sIPaddressintheprinterdefinition.
Ifyourinstallationwantstominimizetheadministrationofprinterdefinitions,thismeansthattheadministratorcandefineoneIPPrintWayprinterdefinitionforallprintersthathavethesameprintingrequirements.
vTheapplicationprogrammercanspecifyInfoprintServerjobattributesontheDDstatement.
TousethePrintInterfacesubsystem,theapplicationprogrammerspecifiestheSUBSYSparameterontheDDJCLstatementforthedataset.
SUBSYSsubparametersincludethenameofthePrintInterfacesubsystem,thenameofaprinterdefinitiondefinedintheInfoprintServerPrinterInventory,andoptionalInfoprintServerjobattributes.
ThePrintInterfacesubsystemalsosupportsmostparametersoftheDDandOUTPUTJCLstatementsthataresupportedforJESsysoutdatasets.
BecausetheadministratorcanspecifydefaultvaluesforthesupportedJCLparametersintheprinterdefinition,theapplicationprogrammerdoesnotneedtocodeJCLparametersthathavesuitabledefaultvalues.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationCreateprinterdefinitionsinthePrinterInventory.
Intheprinterdefinitions,specifydatastreamtransforms.
ApplicationDevelopmentSpecifytheSUBSYSparameterontheDDstatementfordatasetsthatneedtobetransformedtoanotherdataformat.
PrintInterfaceSubsystem42z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||||||||||||||||||||||||||||||||||||AreaConsiderationsAuditingReviewaccountingroutinesthatexamineSMFtype6recordswrittenbyPSF.
CustomizationvCustomizedatatransformsyouplantouseiftheyarenotalreadycustomized.
vCustomizePrintInterfaceandthePrintInterfacesubsystem.
DiagnosisNone.
GeneralUserSeetheApplicationDevelopmentsectionofthistable.
OperationsStartandstopthePrintInterfacesubsystem.
InterfacesSee"ConfigurationFiles"onpage111,"Exits"onpage113,"JCLParametersonOUTPUTandDDStatements"onpage126,"StartupandShutdownProcedures"onpage133,and"z/OSUNIXCommands"onpage139.
DependenciesApplyInfoprintServerPTFUW88209toobtainthisenhancementinz/OSV1R2andlaterreleases.
TotransformPCL,PostScript,andPDFdatatoAFPformat,theTransformstoAFPfeatureofInfoprintServerTransforms(5697–F51)isrequired.
ThisfeatureisavailableatnoextrachargetoInfoprintServercustomers.
TotransformlineorAFPdatatoanotherformat,thefollowingpricedfeaturesofInfoprintServerTransformsarerequired:vAFPtoPCLfeaturevAFPtoPDFfeaturevAFPtoPostScriptfeatureToprinttoIBMAFPprinters,PSFforOS/390(5655–B17)isrequired.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationCustomizetherequiredtransforms.
Ifyouhavealreadycustomizedtransforms,noadditionalcustomizationisrequred.
Requiredz/OSInfoprintServerCustomizationIntheJES2OUTCLASSstatementsorJES3SYSOUTstatements,specifynoblanktruncationforallJESoutputclassesinwhichthePrintInterfacesubsystemcanallocatedatasets.
Requiredz/OSInfoprintServerCustomizationIfyoudonotalreadyrunPrintInterface,edittheBPXPRMxxmemberofSYS1.
PARMLIBtoincreasethemaximumnumberofactiveprocesses.
Requiredz/OSInfoprintServerCustomizationPrintInterfaceSubsystemChapter3.
z/OSVersion1Release2Overview43||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||TaskConditionReferenceInformationEdittheInfoprintServerconfigurationfiletorequestthatthePrintInterfacesubsystemdaemonbestarted.
Requiredz/OSInfoprintServerCustomizationIncreasethemaximumnumberoftransformdaemonsthatcanbeactiveifjobsusethePrintInterfacesubsystemtowritedatatomultipledatasetsinthesamejobstep.
Optionalz/OSInfoprintServerCustomizationCreateprinterdefinitionsinthePrinterInventoryandrequesttheappropriatetransformsintheprinterdefinitions.
Nochangesarerequiredtoexistingprinterdefinitionsthatalreadyrequesttransforms.
Requiredz/OSInfoprintServerOperationandAdministrationStartthePrintInterfacesubsystemdaemon.
Requiredz/OSInfoprintServerOperationandAdministrationOntheDDstatementsfordatasetsthatneedtobetransformedtoanotherdataformat,specifytheSUBSYSparameterwiththefollowingsubparameters:vNameofthePrintInterfacesubsystemvNameoftheprinterdefinitionvInfoprintServerjobattributesCodeothersupportedparametersonDDandOUTPUTJCLstatements.
Requiredz/OSInfoprintServerUser'sGuideStopthePrintInterfacesubsystemifaproblemoccurs.
Optionalz/OSInfoprintServerOperationandAdministrationReviewaccountingroutinesthatexamineSMFtype6recordswrittenbyPSF.
IfthePrintInterfacesubsystemisused,theSMF6USIDfieldcontainstheuserIDoftheuserwhostartedthesubsystem.
Optionalz/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerOperationandAdministrationvz/OSInfoprintServerUser'sGuidePrintInterfaceSubsystem44z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||PSFforOS/390FSADefinitionEnhancementsDescriptionInfoprintServernowletsthePSFsystemprogrammerspecifyadditionalconfigurationinformationinthePrinterInventory.
PSFforOS/390canusethisinformationwhenitstartsaPSF-controlledprinter.
ThefollowingnewfieldscanbespecifiedintheFSAdefinition:vRetainedResourceCountsfields:Thesefieldsletyouspecifythenumberofformdefinitions,pagedefinitions,pagesegments,fonts,andobjectcontainersthatyouwantPSFtoretaininprinterstorageorvirtualstoragebetweenprintjobs.
Thesevaluesoverridethereasonableresourceloadingvalues(RRLV)thatyoucanspecifyinthePSFExit7initializationcall.
vSaveprintercharacteristicsfield:ThisfieldletsyourequestthatPSFsaveinformationabouttheprinter,includingtheprinter'smodelandsupportedfeatures,toassistIBMindiagnosingproblems.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationSpecifynewfieldsintheFSAdefinitionforaPSFforOS/390printer.
DiagnosisSpecifytheSaveprintercharacteristicsfieldtoassistIBMindiagnosingproblems.
GeneralUserNone.
OperationsNone.
InterfacesSee"InfoprintServerISPFPanels"onpage124and"PIDUPrinterAttributes"onpage130.
DependenciesApplyInfoprintServerPTFUW83615toobtainthisenhancementinz/OSV1R2andlaterreleases.
NotallreleasesofPSFsupportthesenewfields.
RefertoPSFforOS/390&z/OS:CustomizationtoseeifyourreleaseofPSFsupportsthem.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
PSFFSADefinitionEnhancementsChapter3.
z/OSVersion1Release2Overview45||||||||||||||||||||||||||||||||||||||||||||||||||||TaskConditionReferenceInformationSpecifythenewfieldsinthePrinterInventoryifthedefaultvaluesarenotsuitable,andrestarttheprintertopickupthechanges.
Optionalz/OSInfoprintServerCustomizationForMoreInformationFormoredetailedinformationaboutthissupport,refertoz/OSInfoprintServerCustomization.
PSFFSADefinitionEnhancements46z/OSV1R2.
0InfoprintServerMigration||||||||||||||SampleCustomizationFilesDescriptionInfoprintServernowprovidesthefollowingnewsamplefilesinSYS1.
SAMPLIB.
ThesefilescanhelpinstallationscustomizeInfoprintServerforthefirsttime:vAOPCPETC:ThisfilecopiesalloftheInfoprintServersampleconfigurationfilestoadirectorywhereyoucaneditthem.
vAOPRACF:ThisfilecontainsalltheRACFcommandsyouneedinordertocustomizethesecurityfunctioninInfoprintServer.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationThesystemprogrammercannowusethenewsamplefilestocustomizeInfoprintServer.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
InterfacesSeeTable33onpage136.
MigrationTasksNonewmigrationtasksareassociatedwiththisenhancement.
ThisenhancementhelpsinstallationscustomizeInfoprintServerforthefirsttime.
ForMoreInformationFormoredetailedinformationaboutthissupport,refertoz/OSInfoprintServerCustomization.
SampleCustomizationFilesChapter3.
z/OSVersion1Release2Overview47|||||||||||||||||||||||||||||||||||||||SecureEnvironmentDescriptionInordertoprovideamoresecureenvironmentforInfoprintServer,allinstallationsmustnowdefinecertainenvironmentvariablesthatInfoprintServerusesinanewaopstartREXXEXEC,whichreplacestheexistingaopstartcommand.
TheaopstartEXECmustbeownedbyUIDof0.
YourinstallationcancopyandmodifythenewaopstartEXECifyouneedtochangetheenvironmentvariablesthatarespecifiedinthedefaultaopstartEXECshippedwithInfoprintServer.
ThedefaultaopstartEXECissuitableformostinstallations.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationCustomizethenewaopstartEXECtospecifyorchangeenvironmentvariables.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
InterfacesSeeTable36onpage139.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallations.
Optionaltasksapplyonlytospecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
SecureEnvironment48z/OSV1R2.
0InfoprintServerMigration|||||||||||||||||||||||||||||||||||||||||TaskConditionReferenceInformationSpecifyenvironmentvariablesintheaopstartEXECifanyofthefollowingconditionsapply:vInfoprintServerexecutablefiles,messagefiles,andconfigurationfilesarenotinthedefaultlocationsvInfoprintServerTransformsconfigurationfilesarenotinthedefaultlocationsvLEandC++run-timelibrariesarenotinSYS1.
LNKLSTvYouhavedefinedmultipleTCP/IPstacksvYouruntheInfoprintServerSAPOutputManagementSystem(OMS)vYourunthePrintInterfaceIPPserverandJava1.
3librariesarenotinthedefaultdirectoriesvYouwanttochangethedefaulttracedirectoryOptionalz/OSInfoprintServerCustomizationEnsurethatthe/etc/Printsrvdirectory,theaopd.
conffile,andtheaopxfd.
conffilearewriteableonlybyauserwithaneffectiveuserIDof0.
Thisensuresthemostsecureenvironment.
Optionalz/OSInfoprintServerCustomizationRemoveanyInfoprintServerenvironmentvariablesfromthe/etc/rcfilethatarenowdefinedintheaopstartcommand.
Theseenvironmentvariableswillbeignoredifspecifiedinthe/etc/rcfile.
Optionalz/OSInfoprintServerCustomizationRemovetheAOPXFD_CONFenvironmentvariablefromthe/etc/profilefile.
Thisenvironmentvariableisignoredwhenspecifiedinthe/etc/profilefile.
Optionalz/OSInfoprintServerCustomizationForMoreInformationFormoredetailedinformationaboutthissupport,refertoz/OSInfoprintServerCustomization.
SecureEnvironmentChapter3.
z/OSVersion1Release2Overview49|||||||||||||||||||||||||||||||||||||||||||||||||||SecureEnvironment50z/OSV1R2.
0InfoprintServerMigrationChapter4.
OS/390Version2Release8OverviewThefollowingsectionsdescribethenewandchangedfunctionsthatwereintroducedtoInfoprintServerandInfoprintServerTransformsinOS/390Version2Release8(V2R8).
Theinformationabouteachitemincludes:vDescriptionvSummaryoftheInfoprintServertasksorinterfacesthatmaybeaffectedvCoexistenceconsiderations,ifany,thatareassociatedwiththeitemvMigrationtasks,ifany,thatareassociatedwiththeitemvReferencestootherpublicationsthatcontainadditionaldetailedinformationNote:Somemigrationtasksarerequiredwhetherornotyourinstallationplanstouseaneworchangedfunction.
See"ActionsRequiredforAllMigrations"onpage4forthemigrationtasksthatarerequiredbyallinstallations,evenifyourinstallationdoesnotplantoimplementanyofthenewfunctions.
ReleaseSummaryTable10liststheenhancementstoInfoprintServerinOS/390V2R8.
Formoreinformation,refertothedetailedsectionforeachitem.
Table10.
SummaryofInfoprintServerEnhancementsforOS/390Version2Release8ForInformationAbout:SeePage:PrinterInventory53Transforms60AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransforms62KanjiAFPPrintFeature65TransformEnhancements66PrintInterfaceRemoteTransforms68PrintInterfaceIPPServer70PrintInterfaceDynamicAllocationEnhancements71PrintInterfaceAOPPRINTJCLProcedure72PrintInterfacelpCommandEnhancements73PrintInterfaceSMBProtocolSupport76InfoprintPortMonitorforWindowsEnhancements78PrintInterfaceFilterEnhancements79PrintInterfaceAPI80PrintInterfaceSAPOutputManagementSystem81PrintInterfaceLPDCompatibilityFilter83NetSpoolOperatorCommandEnhancements85NetSpoolDynamicAllocationEnhancement87IPPrintWayStartupEnhancements88IPPrintWayIPPClient90IPPrintWayPrinterSelectionwithFSSDATAJCLParameter92IPPrintWayExtendedRoutingCriteria94IPPrintWayCodePageConversion96CopyrightIBMCorp.
1999200251||Table10.
SummaryofInfoprintServerEnhancementsforOS/390Version2Release8(continued)ForInformationAbout:SeePage:IPPrintWayPrinterInstructionEnhancements98IPPrintWayCoordinationwithPrintInterfaceandNetSpool99IPPrintWayRestrictPorts101IPPrintWayTransformFunction102IPPrintWayVTAMPrinterSupport104SNMPSubagent106PSFforOS/390StartupEnhancements108OS/390V2R8Overview52z/OSV1R2.
0InfoprintServerMigrationPrinterInventoryDescriptionAllInfoprintServercomponentsnowuseacommonPrinterInventorymanagedbyanewInfoprintServercomponent,thePrinterInventoryManager.
TheadministratorcancreatethefollowingtypesofentriesinthisPrinterInventory:vPrinterdefinitions:TheadministratorcreatesaprinterdefinitionforeachprintertowhichNetSpool,PrintInterface,orIPPrintWaycanprint.
ThesamedefinitioncontainsallprinterinformationrequiredbyNetSpool,PrintInterface,andIPPrintWay.
vComponents:Tomanagealargenumberofprinterdefinitions,theadministratorcancreatecomponents.
Componentscontainprinterinformationcommontomorethanoneprinterdefinition;onecomponentcanbeincludedinmultipleprinterdefinitions.
vPrinterpooldefinitions:IfyourinstallationusesNetSpool,theadministratorcancreateprinterpooldefinitions.
PrinterpooldefinitionslisttheprinterdefinitionstowhichNetSpoolcanbroadcastdata.
vFSSandFSAdefinitions:IfyourinstallationusesIPPrintWayorPSFforOS/390,theadministratorcancreateFSSdefinitionsandFSAdefinitionstospecifyIPPrintWayorPSFconfigurationinformation.
TheadministratorusesnewInfoprintServerISPFpanelstocreateandmanageentriesinthePrinterInventory.
TheadministratorcanalsousethePrinterInventoryDefinitionUtility(PIDU)tocreateandeditlargenumbersofentriesatonetime.
InfoprintServerprovidesamigrationprogramtohelpmigrateexistingIPPrintWay,NetSpool,andPrintInterfaceprinterinformationtothePrinterInventory.
SeeChapter6,"InfoprintServerMigrationProgram"onpage141formoreinformation.
YoumustprovidetheexistingIPPrintWayroutingandoptionsdatasets;NetSpoolprint-characteristicsdatasets,tables,andstartupprocedures;andPrintInterfaceprinterinventoryasinputtothismigrationprogram.
Note:DonotconfusethenewInfoprintServerPrinterInventorywiththePrintInterfaceprinterinventoryfrompreviousreleases.
ThePrintInterfaceprinterinventoryisnowobsolete.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
UsethetablefortheInfoprintServercomponentfromwhichyouaremigrating(PrintInterface,NetSpool,orIPPrintWay).
PrinterInventoryChapter4.
OS/390Version2Release8Overview53ThefollowingtabledescribesareasaffectedininstallationsthatcurrentlyrunPrintInterface.
AreaConsiderationsforPrintInterfaceAdministrationTheadministratornolongercreatesprinterdefinitionsinthePrintInterfaceprinterinventory.
Instead,theadministratorcreatesprinterdefinitionsand,optionally,componentsinthePrinterInventory.
TheadministratornolongerusesPrintInterfaceISPFpanelstocreateprinterdefinitions.
Instead,theadministratorusesInfoprintServerISPFpanelsand,optionally,thePIDUprogramtocreateandmanageentriesinthePrinterInventory.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationThesystemprogrammermustsettheNLSPATHenvironmentvariabletoanewvalueforEnglishmessagesandperiodicallybackupthePrinterInventory.
TheInfoprintServerconfigurationfilealsonowletsyouspecifyanameforthePrinterInventory.
DiagnosisPrintInterfacemessagesmightnowreporterrorsfromthePrinterInventoryManager.
TodiagnoseproblemsrelatedtothePrinterInventory,thediagnosticianmightneedtousetheInfoprintServertracecommands.
GeneralUserNone.
OperationsTheoperatorcanstartthePrinterInventoryManagerusingeithertheaopstartcommandoranewstartupprocedureprovidedwithInfoprintServer.
InterfacesSeeChapter5,"SummaryofInterfaceChanges"onpage109fortheinterfacechangesrelatedtothePrinterInventoryenhancement.
ThefollowingtabledescribesareasaffectedininstallationsthatcurrentlyrunNetSpool.
PrinterInventory54z/OSV1R2.
0InfoprintServerMigrationAreaConsiderationsforNetSpoolAdministrationTheadministratornolongerspecifiesprinterinformationinaNetSpoolprint-characteristicsdatasetorinIPPrintWayroutingandoptionsdatasets;andtheadministratornolongercreatesentriesinend-of-filerulestablesanddefaultpage-formattables.
Instead,theadministratorspecifiesthesameinformationinprinterdefinitionsinthePrinterInventory.
Optionally,theadministratorcanspecifysomeprinterinformationincomponentsthatareincludedinseveralprinterdefinitions.
Forexample,insteadofspecifyingend-of-filerulesinaNetSpoolend-of-filerulesentry,theadministratorcanspecifythesameinformationinaNetSpoolEnd-of-FilecomponentinthePrinterInventory;insteadofspecifyingdefaultpage-formatinformationinapage-formatentry,theadministratorcanspecifythesameinformationinaProcessingcomponentinthePrinterInventory.
InsteadofconcatenatingOUTPUTJCLstatementsintheNetSpoolstartupproceduretobroadcastdatatomultipleprinters,theadministratornowcreatesprinterpooldefinitionsinthePrinterInventory.
TheadministratornolongerusestheAPIPPEFMandAPIPPDPFmacrostocreatetheend-of-filerulestableandpage-formattable.
TheadministratornowusesInfoprintServerISPFpanelsand,optionally,thePIDUprogramtocreateandmanageentriesinthePrinterInventory.
ApplicationDevelopmentNone.
AuditingAccesstothePrinterInventoryandcommandstostartandstopthePrinterInventoryManageriscontrolledbypermittinguserstoRACFgroupsAOPOPERandAOPADMIN.
CustomizationThesystemprogrammermustnowcustomizethePrinterInventoryManager.
NetSpoolstartupproceduresmustidentifythePrinterInventory,andconcatenatedOUTPUTJCLstatementsarenolongerrequiredtobroadcastdatatomultipleprinters;see"NetSpoolDynamicAllocationEnhancement"onpage87foradditionalchangestoNetSpoolstartupprocedures.
Also,NetSpoolexitsmustnowbeAPFauthorized.
DiagnosisNetSpoolmessagescannowreporterrorsfromthePrinterInventoryManager.
TodiagnoseproblemsrelatedtothePrinterInventory,thediagnosticianmightneedtouseInfoprintServertracecommandsandtheInfoprintServerISPFtracefacility.
Also,NetSpoolnowgeneratesSVCdumpsinsteadofABENDdumps.
GeneralUserNone.
OperationsTheoperatormuststartthePrinterInventoryManagerbeforestartingNetSpool,usingeithertheaopstartcommandorastartupprocedure.
TheoperatornolongerneedstousetheREFRESHandRELOADoperatorcommandsbecauseNetSpoolautomaticallypicksupchangesmadeinthePrinterInventory.
TheoperatornolongerneedstousetheLUNAMEADDcommandtostartaNetSpoolprinterLUafterNetSpoolisstarted,becauseNetSpoolautomaticallystartsnewlydefinedprintersthatareinoneofthestartedclasses.
See"NetSpoolOperatorCommandEnhancements"onpage85foradditionalchangestoNetSpooloperatorcommands.
InterfacesSeeChapter5,"SummaryofInterfaceChanges"onpage109fortheinterfacechangesrelatedtothePrinterInventoryenhancement.
PrinterInventoryChapter4.
OS/390Version2Release8Overview55ThefollowingtabledescribesareasaffectedininstallationsthatcurrentlyrunIPPrintWay.
AreaConsiderationsforIPPrintWayAdministrationTheadministratornolongercreatesroutingentriesinaroutingdatasetandoptionsentriesinanoptionsdataset.
Instead,theadministratorspecifiesroutingandoptionsinformationtogetherinprinterdefinitions.
Optionally,theadministratorcanspecifysomeprinterinformationincomponentsthatareincludedinseveralprinterdefinitions.
Forexample,insteadofspecifyingoptionsinanIPPrintWayoptionsentry,theadministratorcanspecifythesameinformationinProcessing,IPPrintWayOptions,andProtocolcomponentsinthePrinterInventory.
TheadministratornolongerusesIPPrintWayISPFpanelsortheANFGPWFLmacrotocreateroutingandoptionsentries.
InsteadtheadministratorusesInfoprintServerISPFpanelsand,optionally,thePIDUprogramtocreateandmanageentriesinthePrinterInventory.
ApplicationDevelopmentNone.
AuditingAccesstothePrinterInventoryandtocommandsthatstartandstopthePrinterInventoryManagerarecontrolledbypermittinguserstoRACFgroupsAOPOPERandAOPADMIN.
CustomizationThesystemprogrammermustnowcustomizethePrinterInventoryManager.
TheIPPrintWaystartupproceduremustidentifythePrinterInventoryinsteadoftheroutingandoptionsdatasets.
See"IPPrintWayStartupEnhancements"onpage88foradditionalchangestothestartupprocedure.
Also,theuserIDthatstartsIPPrintWaymustbedefinedasaz/OSUNIXuser.
BecausedataareaANFUEXTPhaschanged,exitsthatinspectormodifyIPPrintWayoptionsmustnowusenewinputandoutputfieldnames.
BecausetheformatoftheIPPrintWaytransmissionqueuehaschanged,anewtransmission-queuedatasetmustbeallocatedandinitialized.
DiagnosisIPPrintWaymessagesmightnowreporterrorsfromthePrinterInventoryManager.
TodiagnoseproblemsrelatedtothePrinterInventory,thediagnosticianmightneedtouseInfoprintServertracecommandsandtheInfoprintServerISPFtracefacility.
GeneralUserNone.
OperationsTheoperatormustnowstartthePrinterInventoryManagerbeforestartingIPPrintWay,usingeithertheaopstartcommandorastartupprocedure.
TheoperatornowusesInfoprintServerISPFpanels,insteadofIPPrintWayISPFpanels,tomanagetheIPPrintWaytransmission-queuedatasetandtoviewtheIPPrintWaymessage-logdataset.
InterfacesSeeChapter5,"SummaryofInterfaceChanges"onpage109fortheinterfacechangesrelatedtothePrinterInventoryenhancement.
PrinterInventory56z/OSV1R2.
0InfoprintServerMigration|||||DependenciesBeforeNetSpoolorIPPrintWaystarts,thePrinterInventoryManagermustbecustomizedandstarted.
CoexistenceConsiderationsThePrinterInventorycannotbesharedwithanyInfoprintServercomponentsrunningatthesameordifferentlevelsonothersystems.
BecausetheIPPrintWaytransmission-queuedatasetisaVSAMdataset,itcanbesharedwithinstancesofIPPrintWayrunningatthesamelevelonothersystems;however,becausetheformatofthetransmission-queuehaschanged,thisdatasetcannotbesharedwithanotherinstanceofIPPrintWayrunningatapreviouslevelonanothersystem.
Refertoz/OSInfoprintServerCustomizationforreasonswhyyoumightwanttosharethetransmission-queuedataset.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallations.
Optionaltasksapplyonlywhentheconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
ThefollowingtabledescribesmigrationtasksforinstallationsthatcurrentlyrunPrintInterface.
TaskforMigratingfromPrintInterfaceConditionReferenceInformationKeepyourPrintInterfaceconfigurationfileinthesamedirectory;itsdefaultlocationis/etc/Printsrv/aopd.
conf.
Optionally,addtheinventorystatementtochangethenameofthePrinterInventory.
Requiredz/OSInfoprintServerCustomizationChangetheNLSPATHenvironmentvariablein/etc/profiletospecify/usr/lpp/Printsrv/En_US/%Nor/usr/lpp/Printsrv/%L/%N.
(NotethechangetoanuppercaseEinEn_US.
)Requiredz/OSInfoprintServerCustomizationStopandrestartthePrinterInventoryManagerdaemon(aopd).
RestartthisdaemonbeforecreatingthePrinterInventory.
Requiredz/OSInfoprintServerOperationandAdministrationRunthemigrationprogramandthePIDUprogramtocreateprinterdefinitionsinthePrinterInventoryfromprinterdefinitionsinthePrintInterfaceOS/390V2R5-V2R7printerinventory.
1RequiredChapter6,"InfoprintServerMigrationProgram"onpage141ConcatenatelibraryAOP.
SAOPEXECtotheSYSEXECstatementinyourTSOlogonprocedures;removetheANF.
SANFEXEClibrary,whichisobsolete.
Requiredz/OSInfoprintServerCustomizationCustomizeISPFtoincludeanentryfortheInfoprintServerISPFpanels.
Optional:IfyoudonotusethestandardISPFpanelsprovidedwithz/OS.
z/OSProgramDirectoryPrinterInventoryChapter4.
OS/390Version2Release8Overview57TaskforMigratingfromPrintInterfaceConditionReferenceInformationUseInfoprintServerISPFpanelsorthePIDUprogramtocreateoreditprinterdefinitions.
Optional:Tocreateoreditprinterdefinitionsz/OSInfoprintServerOperationandAdministrationUsenewdiagnosticproceduresforproblemswiththePrinterInventory.
Optional:Ifproblemsarisez/OSInfoprintServerMessagesandDiagnosis1.
RunthemigrationprogramoncetomigratefromPrintInterface,NetSpool,andIPPrintWayatthesametime.
ThefollowingtabledescribesmigrationtasksforinstallationsthatcurrentlyrunNetSpool.
TaskforMigratingfromNetSpoolConditionReferenceInformationCustomizethePrinterInventoryManager.
Requiredz/OSInfoprintServerCustomizationStartthePrinterInventoryManagerdaemon(aopd).
StartthisdaemonbeforecreatingthePrinterInventoryandbeforerestartingNetSpool.
Requiredz/OSInfoprintServerOperationandAdministrationRuntheInfoprintServermigrationprogramandthePIDUprogramtocreateprinterdefinitionsinthePrinterInventoryfromNetSpoolprinterdefinitions,pageformattables,andend-offilerulestables.
1RequiredChapter6,"InfoprintServerMigrationProgram"onpage141ChangeyourNetSpoolstartupprocedurestospecifytheINVparameter(withthenameofthePrinterInventory)andtoremoveunusedparameters(WTOR).
RestartNetSpoolwiththenewstartupprocedure.
Requiredz/OSInfoprintServerCustomizationModifyyourNetSpooloperatorproceduresasdescribedin"WhatThisChangeAffects"onpage53.
Requiredz/OSInfoprintServerOperationandAdministrationLink-edityourNetSpoolexitsintoAPF-authorizedlibraries.
Optional:IfyouuseNetSpoolexitsz/OSInfoprintServerCustomizationUsetheInfoprintServerISPFpanelsorthePIDUprogramtocreateoreditprinterdefinitions.
Optional:Tocreateoreditprinterdefinitionsz/OSInfoprintServerOperationandAdministrationUsenewdiagnosticprocedurestodiagnoseproblemsinthePrinterInventoryManager.
Optional:Ifproblemsarisez/OSInfoprintServerMessagesandDiagnosis1.
RunthemigrationprogramoncetomigratefromPrintInterface,NetSpool,andIPPrintWayatthesametime.
PrinterInventory58z/OSV1R2.
0InfoprintServerMigrationThefollowingtabledescribesmigrationtasksforinstallationsthatcurrentlyrunIPPrintWay.
TaskforMigratingfromIPPrintWayConditionReferenceInformationCustomizethePrinterInventoryManager.
Requiredz/OSInfoprintServerCustomizationStartthePrinterInventoryManagerdaemon(aopd).
StartthisdaemonbeforecreatingthePrinterInventoryandbeforerestartingIPPrintWay.
Requiredz/OSInfoprintServerOperationandAdministrationRuntheInfoprintServermigrationprogramandthePIDUprogramtomigrateexistingIPPrintWayroutingandoptionsdatasetstothePrinterInventory.
1RequiredChapter6,"InfoprintServerMigrationProgram"onpage141DeleteyourexistingIPPrintWaytransmissionqueuedataset.
Allocateandinitializeanewtransmission-queuedataset.
Requiredz/OSInfoprintServerCustomizationEnsurethattheuserIDthatstartsIPPrintWayisaz/OSUNIXuserID.
TheuserIDmusthaveanOMVSsegmentandahomedirectory.
Requiredz/OSInfoprintServerCustomizationChangetheIPPrintWaystartupproceduretospecifytheINVparameter(withthenameofthePrinterInventory)andtoremoveunusedparameters.
RestartIPPrintWayFSAsandFSStopickupchangestothestartupprocedure.
Requiredz/OSInfoprintServerCustomizationRemoveOS/390V2R5-V2R7IPPrintWaylibrariesfromyourTSOlogonprocedures;IPPrintWaylibrarieshavehighlevelqualifierANF.
Requiredz/OSInfoprintServerCustomizationInspectIPPrintWayexitroutines;recodeanythatmodifyoptions.
RecompileallIPPrintWayexitroutines.
Optional:IfyouuseIPPrintWayexitsz/OSInfoprintServerCustomizationUsetheInfoprintServerISPFpanelsorthePIDUprogramtocreateoreditprinterdefinitions.
Optional:Tocreateoreditprinterdefinitionsz/OSInfoprintServerOperationandAdministrationUsenewdiagnosticproceduresforproblemsinthePrinterInventoryManagers.
Optional:Ifproblemsarisez/OSInfoprintServerMessagesandDiagnosis1.
RunthemigrationprogramoncetomigratefromPrintInterface,NetSpool,andIPPrintWayatthesametime.
ForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerOperationandAdministrationvz/OSInfoprintServerMessagesandDiagnosisPrinterInventoryChapter4.
OS/390Version2Release8Overview59||||||||TransformsDescriptionInfoprintServerTransformsisaseparatelicensedprogramproductavailablewithInfoprintServer.
ItconsistsofabaseTransformstoAFPfeatureandseveraloptionalfeatures.
TheTransformstoAFPfeatureisavailableatnoextracosttoInfoprintServercustomers.
TheTransformtoAFPfeatureprovidestransformsthatconvertdatatoAdvancedFunctionPresentation(AFP)format(alsocalledMO:DCA-P)forprintingonIBMAFPprinters(alsocalledIPDSprinters).
Thesetransformsare:vPrinterControlLanguage(PCL)5etoAFPtransformvPostScriptLanguageLevel3toAFPtransformvPortableDataFormat(PDF)1.
2toAFPtransformvSAPOutputTextFormat(OTF)Versions1and2andAdvancedBusinessApplicationProgramming(ABAP)Versions1and2toAFPThesetransformsalsoprovide:vz/OSUNIXcommands,pcl2afp,pdf2afp,ps2afp,andsap2afp,whichletuserstransformdatainaUNIXfileorMVSdatasetandcreateanoutputUNIXfileorMVSdataset.
Outputfromthesecommandscanbeprintedorsenttoanotherlocationforprintingorviewing.
vTransformfilters,whichPrintInterfacecanusetoconvertdatabeforewritingoutputtotheJESspool.
InfoprintServerhasaddedthefollowingsupportfortransforms:vPrintInterfacecaninvokethenewtransformfiltersifrequestedintheprinterdefinition.
vAnewTransformManagercomponentofInfoprintServermanagesthePCLandPostScript/PDFtoAFPtransformdaemonsprovidedwithInfoprintServerTransforms.
vAnewfilter-optionsjobattributeletsusersspecifytransformoptionsonthelpcommand,intheAOPPRINTJCLprocedure,andwithanyotherprint-submissionmethodthatletsyouspecifyInfoprintServerjobattributes.
Note:ForinformationaboutoptionalfeaturesofInfoprintServerTransforms,see"AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransforms"onpage62and"KanjiAFPPrintFeature"onpage65.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcanspecifythefilterforthedesiredtransformintheprinterdefinitionsforthetargetprinters.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationThesystemprogrammermustcustomizeInfoprintServerTransformsandtheTransformManager.
DiagnosisNone.
Transforms60z/OSV1R2.
0InfoprintServerMigrationAreaConsiderationsGeneralUserAnInfoprintServerusercanusethez/OSUNIXtransformcommandstotransformPCL,PostScript,PDF,orSAPdatatoAFPformat.
AnInfoprintServerusercanprintPCL,SAP,PostScript,orPDFdocumentstoIBMAFPprintersandcanspecifytransformoptionsinthefilter-optionsjobattribute.
OperationsTheoperatormuststarttheTransformManagerunlessyourinstallationusesonlytheSAPtoAFPtransform.
InterfacesSeeChapter5,"SummaryofInterfaceChanges"onpage109fortheinterfacechangesrelatedtoTransforms.
DependenciesTousetransforms,youmustorderandinstallInfoprintServerTransforms.
NetSpooldoesnotusetransformsprovidedbyInfoprintServerTransforms;however,IPPrintWaynowsupportstransforms;see"IPPrintWayTransformFunction"onpage102forinformation.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationCustomizeInfoprintServerTransformsandtheTransformManager.
Requiredz/OSInfoprintServerCustomizationSpecifytransformfiltersinprinterdefinitions.
Optional:Totransformdataautomaticallywhileprintingz/OSInfoprintServerOperationandAdministrationStarttheTransformManager.
Optional:TotransformPCL,PDF,andPostScriptdata(notrequiredforSAPtransform)z/OSInfoprintServerOperationandAdministrationUsepcl2afp,ps2afp,pdf2afp,andsap2afpcommands.
Optional:Totransformdatawithoutprintingz/OSInfoprintServerUser'sGuideSpecifytransformoptionsinthefilter-optionsjobattributewhensubmittingaprintjob.
Optional:Tospecifyoptionsforspecialprintingneedsz/OSInfoprintServerUser'sGuideForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerOperationandAdministrationvz/OSInfoprintServerUser'sGuidevz/OSInfoprintServerMessagesandDiagnosisRefertotheInfoprintServerTransformsProgramDirectoryforinstallationinformation.
ItcanbeviewedontheWebat:http://www.
ibm.
com/printers/TransformsChapter4.
OS/390Version2Release8Overview61AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsDescriptionInfoprintServerTransformsisaseparatelicensedprogramproductavailablewithInfoprintServer.
ItconsistsofthebaseTransformstoAFPfeatureandseveraloptionalfeatures.
ThreeoptionalpricedfeaturesofInfoprintServerTransformsprovidetransformsthatconvertAdvancedFunctionPresentation(AFP)dataandlinedatatootherdataformats.
Thesetransformsare:vAFPtoPrinterControlLanguage(PCL)5,5e,or5c(color)transformvAFPtoPortableDataFormat(PDF)1.
2(monochromeorcolor)transformvAFPtoPostScriptLanguageLevel2(monochromeorcolor)transformThesetransformsalsoprovide:vz/OSUNIXcommands,afp2pcl,afp2pdf,andafp2ps,whichletuserstransformdatainaUNIXfileorMVSdatasetandcreateanoutputUNIXfileorMVSdataset.
Outputfromthesecommandscanbeprintedorsenttoanotherlocationforprintingorviewing.
UserscanspecifyAFPparameters,suchasaformdefinitionandAFPresourcelibraries,inInfoprintServerjobattributes.
vTransformfilters,whichPrintInterfacecanusetoconvertdatabeforewritingoutputtotheJESspool.
Insupportofthesetransforms,InfoprintServernowprovidesthefollowingfunctions:vTwonewjobattributes,input-tray-numberandoutput-bin-number,letusersspecifyinputtrayandoutputbinnumberstooverridethetrayandbinnumbersintheformdefinition.
Userscanstillspecifytrayandbinnamesintheinput-trayandoutput-binjobattributes.
vPrintInterfacenolongerrejectsprintrequeststhatspecifyjobattributesthatdonotapplytothetargetprinter;instead,PrintInterfaceignoresjobattributesthatdonotapply.
PrintInterfacestillcanvalidatethevaluesthatarespecifiedinjobattributes.
vIPPrintWaytransmitsthefollowingadditionalparameterstoInfoprintManagerforAIX:-ODUPLEX,-OINTRAY,-OOFFSETXB,-OOFFSETXF,-OOFFSETYB,-OOFFSETYF,-OOUTBIN,andtheSOSI3valuein-OPRMODE.
Note:ForinformationabouttheTransformstoAFPfeatureofInfoprintServerTransforms,see"Transforms"onpage60.
ForinformationaboutanotheroptionalfeatureofInfoprintServerTransforms,see"KanjiAFPPrintFeature"onpage65.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcanspecifyafilterforatransformintheprinterdefinitionforthetargetprinter.
ApplicationDevelopmentNone.
AuditingNone.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransforms62z/OSV1R2.
0InfoprintServerMigrationAreaConsiderationsCustomizationThesystemprogrammermustcustomizethetransforms.
ThesystemprogrammermustalsocustomizetheInfoprintServerTransformManagerunlessithasalreadybeencustomized.
DiagnosisThediagnosticiancanuseanewtracefacilityprovidedbythesetransforms.
GeneralUserAlocalz/OSusercanusethez/OSUNIXtransformcommandstoconvertAFPdataandlinedata.
Localz/OSandremoteuserscanprintAFPorlinedatatoPCLandPostScriptprinters.
AFPparameterscanbespecifiedinjobattributesorJCLparameters.
Theusercanalsousetwonewjobattributestospecifytrayandbinnumbers.
OperationsTheoperatormustrestarttheInfoprintServerTransformManager.
InterfacesSee"ConfigurationFiles"onpage111,"Filters"onpage122,"JobAttributes"onpage128,"z/OSUNIXCommands"onpage139,"SYS1.
SAMPLIBMembers"onpage135,and"/usr/lpp/Printsrv/samples/Directory"onpage138.
DependenciesTouseanyofthesetransforms,thefollowingsoftwareisrequired:vTheAFPtoPCL,AFPtoPDF,orAFPtoPostScriptfeatureofInfoprntServerTransformsvAFPFontCollectionVersion1(5648-113)orVersion2(5648-B33)isrequiredtoprovide300-pelrasterfontsandoutlinefonts.
vSonoranEquivalentFontsPRPQ8A5061(5799-FLK)totransformdocumentsthatcontainSonoranSeriforSonoranSansSeriffonts.
vAnAFPpagedefinitionandformdefinitionarerequiredforerrormessagesissuedbythetransforms.
OtherAFPresourcesthatarenotincludedinlineinthedocumentsarealsorequired.
NetSpooldoesnotusetransformsprovidedbyInfoprintServerTransforms.
However,IPPrintWaynowsupportstransforms;see"IPPrintWayTransformFunction"onpage102forinformation.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationCustomizeInfoprintServerTransformsandtheTransformManager.
Requiredz/OSInfoprintServerCustomizationAddanentryforeachtransformyouwanttouseinthetransformconfigurationfile,aopxfd.
conf,andrestarttheTransformManager.
Requiredz/OSInfoprintServerCustomizationRuntheAOXCF30programtoscale240-pelfontsto300-pelrasterfonts;sampleJCLisinSYS1.
SAMPLIB(AOXCF30J).
Optional:Ifyourinstallationhasonly240-pelrasterfonts.
z/OSInfoprintServerCustomizationAFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsChapter4.
OS/390Version2Release8Overview63TaskConditionReferenceInformationModifythefont-mappingtable,AOXFONTS.
Applyausermodtoreplacethetableineachtransform.
Optional:TomapcustomAFPfontsz/OSInfoprintServerCustomizationSpecifytransformfiltersandAFPparametersthatareusedbythetransformsinprinterdefinitions.
Optional:Totransformdataautomaticallywhileprintingz/OSInfoprintServerOperationandAdministrationSpecifyAFPparametersinjobattributesoronanOUTPUTJCLstatementwhensubmittingaprintjob.
Optional:TospecifyAFPparametersthatarenotspecifiedinaprinterdefinition.
z/OSInfoprintServerUser'sGuideUsetheafp2pcl,afp2pdf,andafp2sapcommands.
Optional:Totransformdatawithoutprintingz/OSInfoprintServerUser'sGuideUsenewtracingprocedurestodiagnoseproblemsinthetransforms.
Optional:Ifproblemsarisez/OSInfoprintServerMessagesandDiagnosisForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerOperationandAdministrationvz/OSInfoprintServerUser'sGuidevz/OSInfoprintServerMessagesandDiagnosisRefertotheprogramdirectoriesforeachInfoprintServerTransformsfeatureforinstallationinformation.
TheprogramdirectoriesareprovidedwiththefeaturesandcanbeviewedontheWebat:http://www.
ibm.
com/printers/AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransforms64z/OSV1R2.
0InfoprintServerMigrationKanjiAFPPrintFeatureDescriptionTheInfoprintServerTransformsproductprovidestheKanjiAFPPrintfeatureatnoextracosttoInfoprintServercustomers,TheKanjiAFPPrintfeaturecanbeusedwiththePDFtoAFPandPostScripttoAFPtransforms.
ItletsyouprintPDFandPostScriptdatastreamsthatcontaindouble-bytecharacterset(DBCS)fonts.
ThePDFtoAFPandPostScripttoAFPtransformsmapvariousDBCSfontstotheJapaneseHeiseiKakuGothicW5andHeiseiMinchoW3fonts.
ThesetwoHeiseifontsareprovidedwiththisfeature.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserAusercannowprintJapaneseDBCSPDFandPostScriptdocumentstoIBMAFPprinters.
OperationsNone.
InterfacesNone.
DependenciesYoumustorderandinstalltheKanjiAFPPrintfeatureofInfoprintServerTransforms.
ThePCLtoAFPtransformdoesnotsupportprintingdouble-bytecharactersetdatastreams.
MigrationTasksAfteryouinstallthisfeature,noothertasksarerequiredtousetheHeiseifonts.
ForMoreInformationTheInfoprintServerpublicationsdonotcontainanyadditionalinformationaboutthisfunction.
RefertotheKanjiAFPPrintProgramDirectoryforinstallationinformation.
TheprogramdirectoryisprovidedwiththefeatureandcanbeviewedontheWebat:http://www.
ibm.
com/printers/KanjiAFPPrintfeatureChapter4.
OS/390Version2Release8Overview65TransformEnhancementsDescriptionInfoprintServerTransformsnowsupportsnewenvironmentvariablesandvaluesinthetransformconfigurationfile,aopxfd.
conf:vTheAOP_CUTSHEETvariablecontrolswhetherornottheAFPtoPCL,AFPtoPostScript,andAFPtoPDFtransformspreparedocumentsforprintingoncut-sheetprintersasPSFdoes.
Bydefault,thetransformsdonotpreparedocumentsforcut-sheetprinters.
vThenewAOP_FLATEvariablecontrolswhetherornottheAFPtoPDFtransformcompressesoutput.
Bydefault,thetransformcompressesoutput.
vThenewAOP_PJLvariablecontrolswhetherornottheAFPtoPCLtransformgeneratesPJLcommands.
Bydefault,thetransformgeneratesPJLcommands.
vTheexistingAOP_PAPERvariablenowletsyouspecifytheA5papersize.
Also,theSAPtoAFPtransformnowsupportsmostSAPR/3Release4.
6COTFcommands.
ThetransformtoleratesanyRelease4.
6COTFcommandsthatarenotfullysupported.
Thistransformalsoprovidesenhancedsupportforbarcodes,includingsupportforcustomizingbarcodewidthsandratios.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationThesystemprogrammercanspecifynewenvironmentvariablesandvaluesinthetransformconfigurationfile.
FortheSAPtoAFPtransform,thesystemprogrammercannowcustomizebarcodewidthandratiosupport.
DiagnosisNone.
GeneralUserAnyonewhousesthez/OSUNIXsap2afpcommandcannowcustomizebarcodewidthandratiosupport.
OperationsNone.
InterfacesSeeTable12onpage111.
DependenciesApplythefollowingPTFsifyouwanttousethenewenvironmentvariablesandvalues:vPTFUW79806fortheAFPtoPCLtransformvPTFUW79807fortheAFPtoPostScripttransformvPTFUW79808fortheAFPtoPDFtransformApplythePTFforAPAROW50307ifyouwanttotransformSAPR/3Release4.
6Cdatastreams.
TransformEnhancements66z/OSV1R2.
0InfoprintServerMigration|||||||||||||||||||||||||||||||||||||||||||||||||||||MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplytoonlyspecifiedoperatingenvironmentsortosituationswherethereismorethanonewaytosetuporenablethefunction.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationIntheAFPtoPCL,AFPtoPDF,andAFPtoPostScriptentriesinthetransformconfigurationfile:vAddtheAOP_CUTSHEETvariableifyouwantoutputpreparedforcut-sheetprinters.
vEdittheAOP_PAPERvariableifyouuseA5paper.
Optionalz/OSInfoprintServerCustomizationIntheAFPtoPDFentryinthetransformconfigurationfile,specifytheAOP_FLATEvariableifyouwantincreasedthroughputinsteadofsmallerPDFfiles.
Optionalz/OSInfoprintServerCustomizationIntheAFPtoPCLentryinthetransformconfigurationfile,specifytheAOP_PJLvariableifyourprinterdoesnotacceptPJLcommands.
Optionalz/OSInfoprintServerCustomizationIntheSAPtoAFPbarcode.
tabconfigurationfile,specifythenewModWidthandRatiokeywordstocustomizebarcodesupport.
Optionalz/OSInfoprintServerCustomizationForMoreInformationFormoredetailedinformationaboutthissupport,refertoz/OSInfoprintServerCustomization.
TransformEnhancementsChapter4.
OS/390Version2Release8Overview67||||||||||||||||||||||||||||||||||||||||||||PrintInterfaceRemoteTransformsDescriptionPrintInterfacehasaddedsupportfortransformingdataremotelyonanAIXsystemthatisrunningeitherInfoprintManagerforAIXorPSFforAIX.
ThefollowingremotetransformsaresupportedfortransformingdatatoAdvancedFunctionPresentation(AFP)format.
IBMAFPprinterscanprintdatainAFPformat.
vPrinterControlLanguage(PCL)toAFPvPostScripttoAFPvPortableDataFormat(PDF)toAFP(supportedonlybyInfoprintManagerforAIX)PrintInterfaceprovidesanewfilterprogramtotransformdataremotely.
Also,thenewfilter-optionsjobattributeletsusersspecifytransformoptionsonthelpcommandandAOPPRINTJCLprocedure.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcanspecifytheremotetransformfilterintheprinterdefinitionsforthetargetprinters.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserTheusercanspecifytransformfilteroptionsonthelpcommandandAOPPRINTJCLprocedure.
OperationsNone.
InterfacesSeeTable32onpage135andTable36onpage139.
DependenciesInfoprintManagerforAIXV2R1orhigherorPSFforAIXV2R1mustbeinstalledontheAIXsystem.
NetSpoolandIPPrintWaydonotprovideremotetransformsupport.
UsersmustsubmitprintjobsthatrequireremotetransformstoPrintInterface.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
PrintInterfaceRemoteTransforms68z/OSV1R2.
0InfoprintServerMigrationTaskConditionReferenceInformationSpecifytheremotetransformfilterinprinterdefinitions.
Requiredz/OSInfoprintServerOperationandAdministrationSpecifyfilteroptionsonthelpcommandortheAOPPRINTJCLprocedure.
Optional:Forspecialprintingneedsz/OSInfoprintServerUser'sGuideForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerOperationandAdministrationvz/OSInfoprintServerUser'sGuidePrintInterfaceRemoteTransformsChapter4.
OS/390Version2Release8Overview69PrintInterfaceIPPServerDescriptionThePrintInterfacecomponentofInfoprintServerprovidesanewInternetPrintingProtocol(IPP)server.
TheIPPserveracceptsprintrequestsfromIPPclients,whichtypicallyrunonworkstationplatforms.
PrintInterfaceprocessesthedataandallocatesanoutputdatasetontheJESspool.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationThesystemprogrammermustcustomizethePrintInterfaceIPPserver.
DiagnosisNone.
GeneralUserTheusermustcustomizetheIPPclientontheworkstation.
OperationsTheoperatormuststarttheIPPserver.
InterfacesSeeTable12onpage111,Table14onpage113,andTable32onpage135.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationCustomizethePrintInterfaceIPPserver.
Requiredz/OSInfoprintServerCustomizationStarttheIPPserver.
Requiredz/OSInfoprintServerOperationandAdministrationCustomizetheIPPclientontheworkstation.
Requiredz/OSInfoprintServerCustomizationandz/OSInfoprintServerUser'sGuideForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerUser'sGuidePrintInterfaceIPPServer70z/OSV1R2.
0InfoprintServerMigrationPrintInterfaceDynamicAllocationEnhancementsDescriptionEnhanceddynamicallocationsupportinPrintInterfaceletstheadministratorspecifyadditionalJESoutputparametersinaprinterdefinition.
PrintInterfaceandNetSpoolusethesameJESoutputparameterswhentheyallocatedatasetsontheJESspoolforthesameprinter.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcanspecifyadditionalJESoutputparametersinaprinterdefinitionorinanAllocationcomponent.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
InterfacesNone.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationAddJESoutputparametersinprinterdefinitions(orinAllocationcomponents).
Requiredz/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublication:vz/OSInfoprintServerOperationandAdministrationPrintInterfaceDynamicAllocationEnhancementsChapter4.
OS/390Version2Release8Overview71PrintInterfaceAOPPRINTJCLProcedureDescriptionPrintInterfaceprovidestheAOPPRINTJCLproceduresothatuserscansubmitbatchjobstoprintUNIXfilesandMVSdatasetsusingtheservicesofPrintInterface.
TheuserselectsthetargetprinterbysimplyspecifyingthenameoftheprinterdefinitionforthetargetprinterontheAOPPRINTprocedure;therefore,theuserdoesnotneedtospecifyJESoutputparameters(suchasCLASSorDEST).
Theusercan,however,specifyjobattributesforspecialprintingneeds.
BecausePrintInterfacesupportstransforms,ausercanusetheAOPPRINTproceduretoprintPCL,PostScript,PDF,andSAPfilestoIBMAFPprinters.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentTheapplicationdevelopercanuseAOPPRINT.
AuditingNone.
CustomizationThesystemprogrammercancustomizetheAOPPRINTprocedure.
DiagnosisNone.
GeneralUserTousetheAOPPRINTprocedureusersmustknowthenameoftheprinterdefinitionandbefamiliarwithjobattributes.
OperationsNone.
InterfacesSeeTable32onpage135.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationCustomizetheAOPPRINTprocedure.
Optional:Iffilesandlibrariesarenotindefaultlocationsz/OSInfoprintServerCustomizationUsetheAOPPRINTproceduretoprintfiles.
Requiredz/OSInfoprintServerUser'sGuideForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerUser'sGuidePrintInterfaceAOPPRINTJCLProcedure72z/OSV1R2.
0InfoprintServerMigrationPrintInterfacelpCommandEnhancementsDescriptionThelpcommandhasthefollowingenhancements:vTheshift-out-shift-inattributenowacceptsvaluethree.
vThefollowingjobattributesarenowallowedforIPPrintWayprintersbecauseIPPrintWaycanpasstheseattributestoInfoprintManagerforAIX:chars,form-definition,page-definition,print-error-reporting,andtable-reference-characters.
vTheinput-trayandoutput-binattributesnowacceptanynamesdefinedbytheadministratorintheprinterdefinition;inpreviousreleases,thelpcommandacceptedonlypre-definednames.
vThenewaddress-textattributecanbeusedinsteadoftheaddress1-text,address2-text,address3-text,andaddress4-textattributes,whicharestillsupportedbutnolongerdocumented.
vThecharsandresource-libraryattributesnowrequirethatasetoffontnamesandresourcelibrarynamesbeenclosedinbracesinsteadofinsingleordoublequotationmarks.
vAnewenvironmentvariable,AOPOPTIONS,letsusersspecifycommonly-usedjobattributesforthelpcommand.
PrintInterfacealsoprovidescomparablesupportfortheadministrator:vTheadministratorcannowspecifyvaluethreeinthePRMODEfieldofaprinterdefinition.
vTheadministratorcannowspecifycharactersets,aformdefinitionname,apagedefinitionname,thetypeofprint-errorreporting,andtablereferencecharactersinanIPPrintWayprinterdefinition.
vTheadministratorcannowspecifyanyinputtrayandoutputbinnamesintheprinterdefinition.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcannowspecifytrayandbinnamesinaprinterdefinition.
ApplicationDevelopmentShellscriptsthatusethelpcommandmightneedmodification.
SeeGeneralUserarea.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserAusernowmustenclosevaluesinthecharsorresource-libraryattributesonthelpcommandinbraces.
lpcommandorAOPPRINTuserscanusetheAOPOPTIONSenvironmentvariabletosimplifyspecificationofjobattributes.
OperationsNone.
InterfacesSeeTable36onpage139.
PrintInterfacelpCommandEnhancementsChapter4.
OS/390Version2Release8Overview73MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationReviewshellscriptsandlpcommandattributefiles.
Recodecharsandresource-libraryattributestousebraces.
Optional:Ifyouuseshellscriptsorattributefiles.
z/OSInfoprintServerUser'sGuideUseenhancedjobattributesandAOPOPTIONSenvironmentvariable.
Optional:Tospecifyattributesforaparticularjob.
z/OSInfoprintServerUser'sGuideSpecifynewprinterattributesinprinterdefinitions.
Optional:Tospecifydefaultattributesforalljobsz/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerUser'sGuidevz/OSInfoprintServerOperationandAdministrationPrintInterfacelpCommandEnhancements74z/OSV1R2.
0InfoprintServerMigrationPrintInterfaceJobStatusEnhancementsDescriptionThez/OSUNIXlpstatcommandcannowrecognizethefollowingadditionalstates:vIPPrintWaysuccessfullytransmittedthedatasettotheremoteprinter.
vIPPrintWayfailedtotransmitthedatasettotheremoteprinter.
vPSFforOS/390completedprintingadataset.
vPSFforOS/390failedtoprintthedataset.
vAdatasetwaspurgedfromtheJESspoolbeforeitwasprintedbyPSFforOS/390ortransmittedtoaremoteprinter.
z/OSUNIXusersnowreceivenotificationofjobcompletionimmediatelywithoutthedelaysthatcouldbeexperiencedinpreviousreleases.
Also,notificationoccursassoonasIPPrintWayhasfinishedtransmittingthedatasettotheremoteprinterorhasexhaustedallretryattempts,evenifthedatasetisretainedontheJESspoolattherequestoftheadministratororbecauseanerroroccurred.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserThelpstatcommandreportsmoreaccuratestatus.
z/OSUNIXuserscanreceivemoretimelynotificationofjobcompletionandthefinalstateoftheprintjob.
OperationsNone.
InterfacesSeeTable36onpage139.
MigrationTasksNone.
ForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublication:vz/OSInfoprintServerUser'sGuidePrintInterfaceJobStatusEnhancementsChapter4.
OS/390Version2Release8Overview75PrintInterfaceSMBProtocolSupportDescriptionPrintInterface,inconjunctionwiththez/OSServerMessageBlock(SMB)server,nowletsusersprintonz/OSprintersfromworkstationclientsthatsupporttheSMBprintingprotocol.
Userscansubmitprintjobsandquerythestatusofprintjobs.
Nosupportisprovidedforcancelingprintjobs.
Thez/OSSMBserverispartofthez/OSDistributedFileServiceelement.
WorkstationsthatsupportSMBprotocolincludeWindows2000,Windows98,Windows95,WindowsNT4.
0,andWindows3.
11.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserTheusermustdefinethez/OSprintertotheworkstation.
OperationsNone.
InterfacesNone.
DependenciesTosubmitaprintjobusingSMBprotocol,youdonotneedtoinstalltheInfoprintPortMonitorforWindows.
However,someusersmightwanttousethePortMonitorforbetterz/OSsystemperformanceandtotakeadvantageoftheenhancementsdescribedin"InfoprintPortMonitorforWindowsEnhancements"onpage78.
Refertoz/OSInfoprintServerCustomizationforacomparisonofthefunctionsavailablewhenyouuseSMBprotocolversustheInfoprintPortMonitorforWindows.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationCustomizethez/OSSMBserveranddefineeachprintertothez/OSSMBserver.
Startthez/OSSMBserver.
Requiredz/OSDistributedFileServiceSMBAdministrationDefinethez/OSprintertotheWindowsworkstation.
Requiredz/OSDistributedFileServiceSMBAdministrationPrintInterfaceSMBProtocolSupport76z/OSV1R2.
0InfoprintServerMigrationTaskConditionReferenceInformationCustomizePrintInterfaceRequiredunlessPrintInterfaceisalreadycustomizedz/OSInfoprintServerCustomizationDefineeachprinterinthePrinterInventoryRequiredz/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerandDistributedFileServicepublications:vz/OSInfoprintServerCustomizationvz/OSDistributedFileServiceSMBAdministrationPrintInterfaceSMBProtocolSupportChapter4.
OS/390Version2Release8Overview77InfoprintPortMonitorforWindowsEnhancementsDescriptionTheOS/390V2R8versionoftheInfoprintPortMonitorforWindows,whichrunsonWindows95/98,WindowsNT,andWindows2000,letsusersspecifydistributioninformationthatcanbeprintedontheseparatorpage,suchasnameanddepartment.
UserscanalsospecifyotherjobattributessupportedbyInfoprintServeranddescribedinz/OSInfoprintServerUser'sGuide.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserTheusercanoptionallyspecifyjobattributeswhencustomizingtheInfoprintPortMonitorforWindowsorwhenprintingadocument.
OperationsNone.
InterfacesSee"InfoprintPortMonitorforWindows"onpage124.
DependenciesWindowsuserscancontinuetousethepreviousversionoftheInfoprintPortMonitorforWindowsiftheydonotneedtousetheenhancements.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationUninstallthepreviousversionoftheInfoprintPortMonitorforWindows.
Optional:Ifyouhaveinstalledapreviousversion.
http://www.
ibm.
com/printers/orz/OSInfoprintServerUser'sGuideDownload,install,andcustomizethelatestversionoftheInfoprintPortMonitorforWindows.
Requiredhttp://www.
ibm.
com/printers/orz/OSInfoprintServerUser'sGuideForMoreInformationFormoredetailedinformationaboutthissupport,refertoz/OSInfoprintServerUser'sGuide.
InfoprintPortMonitorforWindows78z/OSV1R2.
0InfoprintServerMigration||PrintInterfaceFilterEnhancementsDescriptionPrintInterfacenowletsaninstallationwriteaUNIX-stylefilterprogramtomodifydatabeforePrintInterfacewritesthedatatotheJESspool.
AUNIXfiltercanbeashellexecutablesuchasaCprogram,aREXXexec,ashellscript,andsoon.
Inpreviousreleases,PrintInterfacesupportedonlyDLL-stylefilters.
BothUNIXfiltersandDLLfilterscannowrequestthatPrintInterfacepassspecificjobattributestothefilter;jobattributesaredescribedinz/OSInfoprintServerUser'sGuide.
Inaddition,DLLfilterscannowsetjobattributes.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationThesystemprogrammercanwriteafiltertousetheenhancements.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
Interfaces"Filters"onpage122MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationEnhancefilterstousenewfunctions.
Youdonotneedtorecompileexistingfilters.
Requiredz/OSInfoprintServerCustomizationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublication:vz/OSInfoprintServerCustomizationPrintInterfaceFilterEnhancementsChapter4.
OS/390Version2Release8Overview79PrintInterfaceAPIDescriptionThePrintInterfacecomponentofInfoprintServerprovidesanapplicationprogramminginterface(API),whichletsyouwriteCorC++applicatonstoperformthefollowingfunctions:vCreateandcancelaprintjobonthez/OSJESspoolvQuerythestatusofaprintjobandthestatusofalljobsforaprintervQueryinformationaboutprintersdefinedinthePrinterInventoryvConnectatransformtotheTransformManagerWhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratormustcreateaprinterdefinitionforthetargetprinterifonedoesnotexist.
ApplicationDevelopmentTheapplicationprogrammerusesthefunctionsprovidedintheAPItocreatejobsandqueryjobstatus.
AuditingNone.
CustomizationThesystemprogrammermustcustomizethePrintInterfacecomponentifithasnotbeencustomized.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
InterfacesSee"ApplicationProgrammingInterface(API)Functions"onpage110and"/usr/lpp/Printsrv/samples/Directory"onpage138.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationUsetheAPIfunctions.
Requiredz/OSInfoprintServerCustomizationCustomizePrintInterfaceOptional:Ifnotalreadycustomized.
z/OSInfoprintServerCustomizationForMoreInformationFordetailedinformationaboutthissupport,refertothefollowingpublication:vz/OSInfoprintServerCustomizationPrintInterfaceAPI80z/OSV1R2.
0InfoprintServerMigrationPrintInterfaceSAPOutputManagementSystemDescriptionThePrintInterfaceSAPR/3OutputManagementSystem(OMS),inconjunctionwiththeSAPR/3ApplicationServerforz/OS,letsSAPR/3usersprintonanyprinterdefinedinthePrinterInventory,canceljobs,obtainaccuratejobstatus,andreceiveimmediatenotificationwhentheirdocumentshavecompleted(successfullyorunsuccessfully).
InfoprintServerisnowSAP-certifiedasinterfacesoftwarefortheSAPR/34.
0system.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheSAPadministratormustdefineanInfoprintServerROMSandLOMStoSAPR/3andcreateSAPoutputdevices.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationThesystemprogrammermustcustomizethePrintInterfaceSAPOMS.
DiagnosisNone.
GeneralUserNoneOperationsTheoperatormustrestartInfoprintServeraftercustomizationofthePrintInterfaceSAPOMS.
InterfacesSee"ConfigurationFiles"onpage111,"EnvironmentVariables"onpage113,"FileSystems—/etcand/varDirectories"onpage122,and"/usr/lpp/Printsrv/samples/Directory"onpage138DependenciesTousetheSAPOMS,theSAPR/3ApplicationServerforz/OS,anSAPproduct,isrequired.
TheSAPR/3ApplicationServerforz/OSspoolworkprocessmustrunonthesamez/OSsystemasInfoprintServer.
ToprinttoIBMAFPprintersonthez/OSsystem,thefollowingsoftwareproductsarerequired:vInfoprintServerTransforms.
TheTransformstoAFPfeatureprovidestheSAPtoAFPtransformatnoextracosttoInfoprintServercustomers.
vPSFV3R1.
0forOS/390(5655-B17),orlater.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
PrintInterfaceSAPOMSChapter4.
OS/390Version2Release8Overview81TaskConditionReferenceInformationDefineanSAPuserfortheCallbackdaemonRequiredz/OSInfoprintServerCustomizationCreatetheSAPCallbackdaemonconfigurationfile,aopsapd.
conf.
Requiredz/OSInfoprintServerCustomizationDefineanInfoprintServerROMSandLOMStotheSAPR/3ApplicationServerforz/OS.
Requiredz/OSInfoprintServerCustomizationCreateSAPoutputdevicesRequiredz/OSInfoprintServerCustomizationCustomizetheSAPtoAFPtransform.
Optional:ToprintSAPOTForABAPdatatoIBMAFPprintersz/OSInfoprintServerCustomizationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublication:vz/OSInfoprintServerCustomizationPrintInterfaceSAPOMS82z/OSV1R2.
0InfoprintServerMigrationPrintInterfaceLPDCompatibilityFilterDescriptionPrintInterfacenowprovidesanLPDcompatibilityfilter,lpd_compat.
so.
Thisfilterprovidesfunctionthatissimilartothefunctionprovidedbythez/OSCommunicationsServer(TCP/IP)LPD.
Forexample,whenyouusefilterlpd_compat.
so,thePrintInterfaceLPDprovidessupportfor:vPrintingaheaderwithapagenumberoneachpage.
vLimitingthenumberoflinesperpageandthenumberofcharactersperline.
TheLPDcompatibilityfilteralsoletsyouspecifyfilteroptions,whichprovideequivalentsupporttothefollowingz/OSTCP/IPoptions:vLPRcommandoptions:FILTER,LINECOUNT,andWIDTH.
vLPDoptionsonSERVICEstatement:PAGESIZEandLINESIZE.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcanspecifyfilterlpd_compat.
sointheprinterdefinition.
Theadministratorcanalsospecifydefaultvaluesforthetypeoffilterprocessing,themaximumlinelength,andthemaximumnumberoflinesperpageApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserAusercanspecifythetypeoffilterprocessing,themaximumlinelength,andthemaximumnumberoflinesperpageintheInfoprintServerfilter-optionsjobattribute,forexample,onthelpcommand.
OperationsNone.
InterfacesSeeTable17onpage123.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationSpecifythelpd_compat.
sofilterandoptionsintheprinterdefinition.
Requiredz/OSInfoprintServerOperationandAdministrationSpecifyfilteroptionsinthefilter-optionsjobattribute.
Optional:Tospecifythetypeoffiltering,maximumlinesperpage,ormaximumlinewidth.
z/OSInfoprintServerUser'sGuidePrintInterfaceLPDCompatibilityFilterChapter4.
OS/390Version2Release8Overview83ForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerOperationandAdministrationvz/OSInfoprintServerUser'sGuidePrintInterfaceLPDCompatibilityFilter84z/OSV1R2.
0InfoprintServerMigrationNetSpoolOperatorCommandEnhancementsDescriptionNetSpooloperatorcommandshavethefollowingenhancements:vTheoperatormustnowusetheMODIFYcommand(anMVScommand)todirectNetSpooloperatorcommandstoNetSpool.
TheoperatorcannolongerreplytoanoutstandingNetSpoolWTORmessage.
Inpreviousreleases,aninstallationcouldchoosewhichmethodtouse.
vTheDISPLAYcommandhastheseenhancements:–TheLUNAMEoptiondisplaysthestatusofaprinterlogicalunit(LU).
–TheTRACEoptionshowsprinterLUsbeingtraced.
(TraceinformationisnolongerdisplayedforotherDISPLAYoptions.
)–Anewstate,PENDINGCLOSE,ispossible.
–TheALLandNOTSELoptionsarenolongersupported.
vThePURGEcommandisnew.
ItcanstopasessionwithaNetSpoolprinterLUimmediately.
Note:See"PrinterInventory"onpage53forotherchangestoNetSpooloperatorcommandsduetothePrinterInventoryenhancement.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationNone.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserNone.
OperationsTheoperatormustusetheMODIFYcommandtoenterNetSpoolcommands.
TheoperatormustuseInfoprintServerISPFpanelstodisplayallprintersdefinedtoNetSpoolinsteadoftheDISPLAYcommand.
InterfacesSeeTable25onpage131.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
RequiredtasksapplytoallinstallationsthatrunNetSpool.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationRemovetheWTORparameterfromtheNetSpoolstartupprocedure.
Requiredz/OSInfoprintServerCustomizationNetSpoolOperatorCommandEnhancementsChapter4.
OS/390Version2Release8Overview85TaskConditionReferenceInformationUsetheMODIFYcommandtoenterNetSpoolcommands;changeuseofDISPLAYcommand;usePURGEcommandforerrorsituations.
Requiredz/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerOperationandAdministrationvz/OSInfoprintServerCustomizationNetSpoolOperatorCommandEnhancements86z/OSV1R2.
0InfoprintServerMigrationNetSpoolDynamicAllocationEnhancementDescriptionNewdynamicallocationsupportinNetSpoolletstheadministratorspecifyJESoutputparametersdirectlyintheprinterdefinitioninsteadofonOUTPUTJCLstatementsintheNetSpoolstartupprocedure.
NetSpoolusestheseJESoutputparameterstodynamicallyallocateanoutputdatasetontheJESspool.
ThemigrationprogramconvertseachOUTPUTJCLstatementinexistingNetSpoolstartupprocedurestoanAllocationcomponentandincludestheAllocationcomponentinthenewprinterdefinitionforthetargetprinter.
Therefore,ifyouusethemigrationprogram,noadditionalmigrationtasksarerequiredtotakeadvantageofthisenhancement.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcannowspecifyJESoutputparametersineachprinterdefinition;ifseveralprinterdefinitionsusethesameoutputparameters,theadministratormightwanttocreateanAllocationcomponentandincludethatcomponentintheprinterdefinitions.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNetSpoolignoresOUTPUTJCLstatementsintheNetSpoolstartupprocedure.
DiagnosisNone.
GeneralUserNone.
OperationsTheoperatornolongerneedstorestartNetSpoolforNetSpooltopickupchangestoJESoutputparametersspecifiedintheNetSpoolstartupprocedure.
NetSpoolcanautomaticallypickupchangesmadetoJESoutputparametersspecifiedinprinterdefinitions.
InterfacesSeeTable32onpage135andTable27onpage133.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Arequiredtaskmustbeperformedregardlessofwhetheryouimplementthisfunctionatyourinstallation.
Anoptionaltaskmustbeperformedonlyiftheconditionismet.
TaskConditionReferenceInformationSpecifyJESallocationparametersinprinterdefinitions.
Optional:TospecifyadditionalOUTPUTparametersz/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublication:vz/OSInfoprintServerOperationandAdministrationNetSpoolDynamicAllocationEnhancementChapter4.
OS/390Version2Release8Overview87IPPrintWayStartupEnhancementsDescriptionIfyourinstallationwantstospecifyIPPrintWaycustomizationinformation(suchasthenumberofhiperspaceblocks,thelanguageforIPPrintWaymessages,andthetypeoftracing),theadministratormustnowspecifythisinformationinthePrinterInventoryinsteadofintheIPPrintWaystartupprocedure.
Tospecifycustomizationinformation,theadministratorcreatesfunctionalsubsystem(FSS)andfunctionalsubsystemapplication(FSA)definitionsinthePrinterInventory.
IPPrintWayusestheinformationintheFSSandFSAdefinitionswhentheIPPrintWayFSSandFSAsstart.
IPPrintWayhasalsoaddedsupporttolettheadministratorspecifyadifferentleveloftracingforeachIPPrintWayFSAintheFSAdefinition;bydefault,thetracingspecifiedintheFSSdefinitionappliestoeachFSA.
TochangethetypeoftracingfortheFSA,theFSSmustberestarted.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTospecifyIPPrintWaycustomizationinformation,theadministratornowcreatesFSSandFSAdefinitionsinthePrinterInventory.
Thesedefinitionsareoptional;IPPrintWayusesdefaultvaluesifthesedefinitionsdonotexist.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationParametersandPRINTDEVJCLstatementsinIPPrintWaystartupproceduresareignored.
DiagnosisTracingparametersarenowspecifiedinIPPrintWayFSSandFSAdefinitionsinthePrinterInventory.
TheadministratorcanspecifyadifferentleveloftracingforeachIPPrintWayFSA.
GeneralUserNone.
OperationsNone.
InterfacesSeeTable20onpage124andTable28onpage134.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationCreateIPPrintWayFSSdefinitionsinthePrinterInventory.
Optional:Ifdefaultconfigurationisnotsuitablez/OSInfoprintServerCustomizationRemoveunsupportedEXECstatementparametersandPRINTDEVstatementsfromtheIPPrintWaystartupprocedure.
Optional:Ifnotremoved,statementsareignored.
z/OSInfoprintServerCustomizationIPPrintWayStartupEnhancements88z/OSV1R2.
0InfoprintServerMigrationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerOperationandAdministrationIPPrintWayStartupEnhancementsChapter4.
OS/390Version2Release8Overview89IPPrintWayIPPClientDescriptionIPPrintWaynowprovidesanInternetPrintingProtocol(IPP)client.
TheIPPrintWayIPPclienttransmitsoutputdatasetsfromtheJESspoolovertheInternettoIPPserversrunningeitherinaprinteroronanotherhostsystem.
TheIPPrintWayIPPclienttransmitsIPPjobattributestotheIPPprinter.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratormustcreateaprinterdefinitionforthetargetprinterandspecifytheUniversalResourceLocation(URL)oftheprinter.
ApplicationDevelopmentNone.
AuditingTheSMFrecordcontainstheURLoftheIPPprinterinthesamefieldastheIPaddress.
CustomizationIPPrintWayexitsmustbeabletoaccepttheURLandIPaddressinthesameinputfield.
TheIPPrintWayroutingexitcannowspecifyaURLwhenreroutingadataset.
DiagnosisNone.
GeneralUserNone.
OperationsIPPrintWaydisplaystheURLofthetargetprinterintheISPFtransmission-queuepanels.
InterfacesSeeTable15onpage113andTable27onpage133.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationAddtheSTDENVDDstatementtotheIPPrintWaystartupprocedure.
Optional:IfyoudidnotinstallInfoprintServerfilesinthedefaultdirectories.
z/OSInfoprintServerCustomizationReviewIPPrintWayexitstodetermineiftheycanacceptaURLinsteadofanIPaddressinthesameinputfield.
Optional:IfyouuseIPPrintWayexitsz/OSInfoprintServerCustomizationCreateaprinterdefinitionforeachprinterandspecifytheURLoftheprinter.
Requiredz/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:IPPrintWayIPPClient90z/OSV1R2.
0InfoprintServerMigrationvz/OSInfoprintServerCustomizationvz/OSInfoprintServerOperationandAdministrationIPPrintWayIPPClientChapter4.
OS/390Version2Release8Overview91IPPrintWayPrinterSelectionwithFSSDATAJCLParameterDescriptionIPPrintWaynowletsusersselectaprinterdefinitionbyspecifyingthenameofthedefinitionintheFSSDATAparameterofanOUTPUTJCLstatement.
Becauseuserscanselectaprinterdefinitionbyname,administratorsnolongerneedtospecifyDEST,CLASS,andFORMSroutingcriteriainaprinterdefinition.
Administratorsanduserscan,however,continuetouseDEST,CLASS,andFORMSroutingcriteriaifdesired.
See"IPPrintWayExtendedRoutingCriteria"onpage94forinformationaboutarelatedenhancement.
WhentheFSSDATAparameterisspecified,userscanalsospecifytheDEST=IP,PRTQUEUE,andPORTNOparametersontheOUTPUTJCLstatementtooverridetheIPaddress,printqueuename,andportnumberintheselectedprinterdefinition.
ThissupportmeansthatuserscanusetheFSSDATAparametertoselectaprinterdefinitionwiththedesiredIPPrintWayoptions,butprinttoprinterswhoseIPaddressesarenotdefinedinthePrinterInventory.
Note:AlthoughusersnolongerneedtospecifyDEST,CLASS,andFORMSroutingcriteriatoselectaprinterdefinition,usersmustcontinuetospecifytheJESwork-selectioncriteriadefinedtoJESfortheIPPrintWayFSA.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationSpecifyingDEST,CLASS,andFORMSforprinterselectionisnowoptionalinaprinterdefinition.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationIPPrintWayexitsmustbeabletoaccepteithertheprinterdefinitionnameortheDEST,CLASS,andFORMSvaluesinthesameinputfield.
BecauseNetSpoolandPrintInterfacenowusetheFSSDATAoutputparameterwhentheyallocatedatasetsontheJESspool,theprinterdefinitionname(insteadoftheDEST,CLASS,andFORMSvalues)isinputtoIPPrintWayexits.
DiagnosisNone.
GeneralUserUserscannowselectIPPrintWayprintersbyspecifyingtheFSSDATA=printerparameteronanOUTPUTJCLstatement,anduserscanoverridetheIPaddressandprintqueuenameorportnumberintheselectedprinterdefinition.
OperationsThenewRouteNamefieldontheISPFtransmission-queueISPFpanelsdisplaystheprinterdefinitionnameortheDEST,CLASS,andFORMSvalues.
InterfacesSeeTable15onpage113andTable21onpage126.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
FormoredetailsontheproceduresassociatedIPPrintWayPrinterSelectionwithFSSDATAParameter92z/OSV1R2.
0InfoprintServerMigrationwithatask,seethereferencelisted.
TaskConditionReferenceInformationCodetheFSSDATAparameteronOUTPUTstatements.
Requiredz/OSInfoprintServerUser'sGuideReviewexitstoseewhethertheyinspectormodifytheDEST,CLASS,andFORMSroutingkey.
Recodeexitsifnecessarytoaccepttheprinternameinthesamefield.
Optional:IfyouuseIPPrintWayexitsandyourinstallationeither(1)usestheFSSDATAparameteronOUTPUTJCLstatementsor(2)runsNetSpoolorPrintInterface.
z/OSInfoprintServerCustomizationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerUser'sGuideIPPrintWayPrinterSelectionwithFSSDATAParameterChapter4.
OS/390Version2Release8Overview93IPPrintWayExtendedRoutingCriteriaDescriptionPriortoOS/390V2R8,theadministratorwasrequiredtospecifyvaluesfortheDEST,CLASS,andFORMSroutingcriteriaineachIPPrintWayroutingentry.
IPPrintWayselectedtheroutingentryonlyifthevaluesforallthreeroutingcriteriaonanOUTPUTJCLstatementmatchedthevaluesspecifiedintheroutingentry.
Thisrequirementmeantthatadministratorsweresometimesforcedtocreateseveralroutingentriesforthesametargetprinter.
StartingwithOS/390V2R8,theadministratorcanomitoneormoreoftheDEST,CLASS,andFORMSvaluesinaprinterdefinition;ifavalueisomitted,IPPrintWaydoesnotusethevalueinthatparameterwhenselectingtheprinterdefinition.
Totakeadvantageofthisenhancement,themigrationprogrammergesmultipleIPPrintWayroutingentriesforthesametargetprinterintooneprinterdefinitionwheneverpossiblebyomittingoneormoreoftheDEST,CLASS,andFORMSparametersintheprinterdefinition.
Themigrationprogramdoessoonlyifallofthemergedroutingentrieshavethesamecontents.
Whenyourunthemigrationprogram,youcansuppressthisfunctionofthemigrationprogram.
See"Options"onpage144foradescriptionofthe-soption,andseesection"MergeIPRoutingCriteria"inAppendixA,"MigrationReport"onpage159foramoredetaileddescriptionofhowthemigrationprogrammergesroutingcriteria.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcanomittheDEST,CLASS,orFORMSvaluewhenspecifyingprinter-selectioncriteriainaprinterdefinition;ifavalueisomitted,IPPrintWayignoresthevalueinthatJCLparameterwhenselectingtheprinterdefinition.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationTheXTPDEST,XTPCLASS,andXTPFORMSfields,whichareinputtosomeIPPrintWayexits,containblanksiftheDEST,CLASS,orFORMSfieldisomittedintheprinterdefinition.
DiagnosisNone.
GeneralUserNone.
OperationsTheRouteNamefieldonthetransmission-queueISPFpaneldisplaystheDEST,CLASS,andFORMSvaluesthatIPPrintWayusedtoselecttheprinterdefinition.
IfIPPrintWaydidnotuseoneofthesevaluestoselecttheprinterdefinition,thevalueisblank.
InterfacesSeeTable15onpage113andTable21onpage126.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
IPPrintWayExtendedRoutingCriteria94z/OSV1R2.
0InfoprintServerMigrationTaskConditionReferenceInformationSpecifyDEST,CLASS,andFORMSforprinterselectioninaprinterdefinition.
Requiredz/OSInfoprintServerOperationandAdministrationReviewexitstoseewhethertheexitscanacceptblanksintheXTPDEST,XTPCLASS,andXTPFORMSfields.
Recodeexitsifnecessary.
Optional:IfyouuseIPPrintWayexitsz/OSInfoprintServerCustomizationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerOperationandAdministrationIPPrintWayExtendedRoutingCriteriaChapter4.
OS/390Version2Release8Overview95IPPrintWayCodePageConversionDescriptionStartingwithOS/390V2R8,IPPrintWayusestheiconvutility,bydefault,toconvertdatafromEBCDICtoASCII.
Theiconvutilityusessource(document)andtarget(printer)codepagestoconvertdata.
Forcompatibilitywithpreviousreleases,IPPrintWaycontinuestoprovidesupportforDBCSandcustomizedTCP/IPEBCDICtoASCIItranslationtables.
Also,theadministratorcanrequestthatIPPrintWay,bydefault,continuetousethestandardTCP/IPEBCDICtoASCIItranslationtable.
Totakeadvantageofthisenhancement,themigrationprogramspecifiesanASCIIcodepageasthetarget(printer)codepageinIPPrintWayprinterdefinitionsthatdonotspecifyDBCSorcustomizedtranslatetables.
YoucanspecifytheASCIIcodepageforthemigrationprogramtouseintheInfoprintServerconfigurationfile.
See"UsageNotes"onpage148formoreinformation.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcannowspecifydocumentandprintercodepagesinprinterdefinitions.
IntheIPPrintWayFSSdefinition,theadministratorcan(1)specifyadefaultsource(document)codepageand(2)requestthatIPPrintWayusethestandardTCP/IPtranslationtablebydefault.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserIftheiconvutilityisused,theusermightseesomedifferencesinoutput.
OperationsNone.
InterfacesSeeTable20onpage124.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationSpecifydocumentandprintercodepagesinprinterdefinitions.
SpecifyadefaultdocumentcodepageintheIPPrintWayFSSdefinition.
Optional:Tousenon-defaultcodepagesz/OSInfoprintServerOperationandAdministrationIPPrintWayCodePageConversion96z/OSV1R2.
0InfoprintServerMigrationTaskConditionReferenceInformationSelecttheOldstyletranslationfieldintheIPPrintWayFSSdefinition.
Optional:TousestandardTCP/IPtranslatetablebydefaultz/OSInfoprintServerOperationandAdministrationNote:IfyouusetheInfoprintServermigrationprogramtoconvertIPPrintWayoptionsentries,andyouwantIPPrintWaytocontinuetousethestandardTCP/IPtranslatetablebydefault,youmusteditthePrinterInventoryentriescreatedbythemigrationprogram.
See"ViewingandEditingthePrinterInventory"onpage155formoreinformation.
ForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublication:vz/OSInfoprintServerOperationandAdministrationIPPrintWayCodePageConversionChapter4.
OS/390Version2Release8Overview97IPPrintWayPrinterInstructionEnhancementsDescriptionInpreviousreleases,theadministratorcouldspecifyprinterinstructionsforIPPrintWaytosendtotheprinteratthebeginningofthedata.
(Printerinstructionswerecalled"printersetupparameters"inpreviousreleases.
)StartingwithOS/390V2R8,IPPrintWayletstheadministratoralsospecifyprinterinstructionsforIPPrintWaytosendtotheprinterattheendofthedata.
Thissupportletsyoureturntheprintertothestatethatexistedbeforeprintingofthedocument.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcannowspecifyinstructionsforIPPrintWaytosendtotheprinterattheendofadataset.
TheinstructionscanbeineitherEBCDICorASCIIrepresentation.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
InterfacesSeeTable20onpage124.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationSpecifyprinterinstructionsintheDocumenttrailerfieldofaprinterdefinition.
Requiredz/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublication:vz/OSInfoprintServerOperationandAdministrationIPPrintWayPrinterInstructionEnhancements98z/OSV1R2.
0InfoprintServerMigrationIPPrintWayCoordinationwithPrintInterfaceandNetSpoolDescriptionWhenIPPrintWayselectsanoutputdatasetfromtheJESspool,IPPrintWaycannowdeterminewhetherPrintInterfaceorNetSpoolallocatedthatdatasetonthespool.
IPPrintWaycantailoritsprocessingaccordingly.
IfPrintInterfaceallocatedthedataset,IPPrintWaydoesnotformatorconvertthedatatoASCII.
ThisisbecausePrintInterfacehasalreadyconverteddatafromEBCDICtoASCII.
ThisenhancementeliminatestheneedfortheadministratortoselecttheNoneoptionintheIPPrintWayFormattingfieldinaprinterdefinitionforPrintInterfacedatasets.
(TheNoneoptionistheoldIPPrintWayBINARYLPRoptioninIPPrintWayISPFpanels.
)IfNetSpoolallocatedthedataset,IPPrintWaytransmitsthedatasettotheprinterimmediatelyanddoesnottrytogrouptheotherdatasetsinthejobtogether.
ThisisbecausealldatasetsallocatedbyNetSpoolappeartobeinthesamejob.
ThisenhancementeliminatestheneedfortheadministratortoselecttheNoneoptionintheDatasetGroupingfieldintheInfoprintServerISPFpanelsforNetSpooldatasets.
(TheDatasetGroupingfieldistheoldTransGroupfieldinIPPrintWayISPFpanels.
)WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratornolongerneedstospecifyanIPPrintWayformattingoptionfordatasetsallocatedontheJESspoolbyPrintInterface.
TheadministratornolongerneedstospecifythetypeofdatasetgroupingrequiredbyNetSpool.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
InterfacesSeeTable20onpage124.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
IPPrintWayCoordinationwithPrintInterfaceandNetSpoolChapter4.
OS/390Version2Release8Overview99TaskConditionReferenceInformationUnderstandhowtospecifytheIPPrintWayFormattingfieldinaprinterdefinition.
Optional:IfyouusePrintInterfaceandwanttochangedefaultformatting.
z/OSInfoprintServerOperationandAdministrationUnderstandhowtospecifytheDatasetgroupingfieldinaprinterdefinition.
Optional:IfyouuseNetSpoolandwanttochangedefaultformatting.
z/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublication:vz/OSInfoprintServerOperationandAdministrationIPPrintWayCoordinationwithPrintInterfaceandNetSpool100z/OSV1R2.
0InfoprintServerMigrationIPPrintWayRestrictPortsDescriptionPriortoOS/390V2R8,theIPPrintWayLPR,bydefault,restricteditselftoOS/390ports721through731.
TheadministratorcouldspecifytheUSERPORTSLPRoptiontocausetheIPPrintWayLPRtouseanyavailableport.
InOS/390V2R8,toincreasetheprobabilityoffindingafreeport,theIPPrintWayLPR,bydefault,usesanyavailableport.
TheadministratorcanselecttheRestrictportsfieldintheprinterdefinitiontocausetheIPPrintWayLPRtorestrictitselftoports721through731.
TheLPDsonsomeplatforms,suchasAIX,requirethattheIPPrintWayLPRrestrictitselftotheseports.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratormustselecttheRestrictportsfieldintheprinterdefinitiontorestrictportstobetween721to731.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationNone.
DiagnosisNone.
GeneralUserNone.
OperationsNone.
InterfacesSeeTable20onpage124.
MigrationTasksIfyouusetheInfoprintServermigrationprogram,noadditionalmigrationtasksarenecessary.
ThemigrationprogramsetstheRestrictportfieldinallIPPrintWayprinterdefinitionssothatIPPrintWayport-selectionbehaviorfortheseprintersremainsthesameasinpreviousreleases.
ForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublication:vz/OSInfoprintServerOperationandAdministrationIPPrintWayRestrictPortsChapter4.
OS/390Version2Release8Overview101IPPrintWayTransformFunctionDescriptionTheIPPrintWaytransformfunction(alsocalledtheResubmitforfilteringfunction)letsyouusedatatransformsprovidedbyInfoprintServerTransformstotransformdatasetssubmitteddirectlytoIPPrintWay.
Thismeansthatyoucannowtransformdatasetsallocatedbyaz/OSbatchapplication,aTSO/Eapplication,orNetSpool.
Previously,youcouldonlytransformdatasetsthatweresubmitteddirectlytoPrintInterface,forexample,fromaremotesystemorwiththelpcommandorAOPPRINTJCLproecedure.
ThisfunctionletsyouuseanytransformprovidedbyInfoprintServerTransforms.
Forexample,youcanusethefollowingtransforms:vAFPtoPCLtransform,whichletsyouprintAFPdocumentstoPCLprintersvAFPtoPostScripttransform,whichletsyouprintAFPdocumentstoPostScriptprintersvAFPtoPDFtransform,whichletsyoucreatePDFoutputforviewingandprintingfromaworkstation.
ThesetransformscanalsoformatlinedatawithapagedefinitionandconvertittoPCL,PostScript,orPDFformat.
See"AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransforms"onpage62formoreinformationaboutthesetransforms.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcanenablethisfunctionandspecifyatransformfilterintheprinterdefinitionforthetargetprinter.
ApplicationDevelopmentNone.
AuditingWhenthisfunctionisenabledintheprinterdefinition,IPPrintWaywritestwoSMFrecordsforadataset.
IPPrintWaywritesthefirstSMFrecordwhentransmittingthedatasettothePrintInterfaceLPDsothatthetransformcanbeperformed;thisrecordcontainstheIPaddressofthez/OSsystem.
IPPrintWaywritesasecondSMFrecordwhentransmittingthedatasettothetargetprinter;thisrecordcontainstheIPaddressofthetargetsystem.
CustomizationThesystemprogrammermustcustomizethePrintInterfaceLPD.
ThesystemprogrammercanwriteanIPPrintWaySMFexittosuppressthefirstSMFrecordwrittenforadataset;see″Auditing″formoreinformation.
DiagnosisNone.
GeneralUserTheusercanusestandardMVSJCLparameterstoprintAFPorlinedatatoaPCLorPostScriptprinter.
OperationsTheoperatormuststartthePrintInterfaceLPD.
InterfacesSee"Exits"onpage113,"InfoprintServerISPFPanels"onpage124,and"JCLParametersonOUTPUTandDDStatements"onpage126.
DependenciesTousethisfunction,InfoprintServerTransformsisrequired.
IPPrintWayTransformFunction102z/OSV1R2.
0InfoprintServerMigrationMigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationSelecttheResubmitforfilteringfieldandspecifyatransformfilterintheprinterdefinition.
Requiredz/OSInfoprintServerOperationandAdministrationCustomizethePrintInterfaceLPD;theLPDmustlistenatport515.
Optional:IftheLPDisnotalreadycustomized.
z/OSInfoprintServerCustomizationStartthePrintInterfaceLPD.
Optional:IftheLPDisnotalreadystarted.
z/OSInfoprintServerOperationandAdministrationWriteanIPPrintWaySMFexittosuppressthefirstSMFrecordwrittenforadataset.
Optional:IfyouraccountingproceduresrequirethatoneoftheSMFrecordsbesuppressed.
z/OSInfoprintServerCustomizationSpecifyJCLparametersusedbythesetransformsonOUTPUTJCLstatements.
Optional:TospecifyAFPparametersnotspecifedintheprinterdefinition.
z/OSInfoprintServerUser'sGuideForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerIntroductionvz/OSInfoprintServerCustomizationvz/OSInfoprintServerOperationandAdministrationvz/OSInfoprintServerUser'sGuideIPPrintWayTransformFunctionChapter4.
OS/390Version2Release8Overview103IPPrintWayVTAMPrinterSupportDescriptionIPPrintWaynowcontainssupportforprintingline-datadocumentsfromtheJESspooltoVTAM-controlledprintersdefinedasVTAMLUtype0,LUtype1,orLUtype3printers.
SupportedoutputdatastreamsareSNACharacterString(SCS)andDataStreamCompatible/DataStreamExtended(DSC/DSE).
YoucanusebatchapplicationstoprintlinedatadocumentstoVTAM-controlledprinters.
Also,youcanusePrintInterfacetoprinttextorlinedata.
Note:ThetermVTAMreferstotheCommunicationsServerSNAServiceselementofz/OS.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratormustcreateaprinterdefinitionforeachprinterandalsodefineeachprintertoVTAMifitisnotalreadydefined.
ApplicationDevelopmentNone.
AuditingNone.
CustomizationAVTAMAPPLstatementisrequiredforeachIPPrintWayFSS.
Also,anFSSdefinitioninthePrinterInventoryisrequiredforeachIPPrintWayFSS.
IPPrintWayexitsmustbeabletoaccepttheVTAMLUnameandIPaddressinthesameinputfield.
TheIPPrintWayroutingexitcannowspecifyaVTAMLUnamewhenreroutingadataset.
DiagnosisNoneGeneralUserNone.
OperationsIPPrintWaydisplaystheVTAMLUnameofthetargetprinterinthetransmission-queuepanels.
InterfacesSeeTable15onpage113.
DependenciesTousethisfunction,theCoaxPrinterSupportfeatureofInfoprintServerTransformsisrequired.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationDefineaVTAMapplicationprogram(APPLstatement)foreachIPPrintWayFSS.
Requiredz/OSInfoprintServerCustomizationIPPrintWayVTAMPrinterSupport104z/OSV1R2.
0InfoprintServerMigrationTaskConditionReferenceInformationSpecifytheAPPLIDsinIPPrintWayFSSdefinitionsinthePrinterInventory.
Requiredz/OSInfoprintServerCustomizationReviewIPPrintWayexitstodetermineiftheycanacceptaVTAMLUnameinsteadofanIPaddressinthesameinputfield.
Optional:IfyouuseIPPrintWayexitsz/OSInfoprintServerCustomizationRestarttheIPPrintWayFSSs.
Requiredz/OSInfoprintServerOperationandAdministrationCreateaprinterdefinitioninthePrinterInventoryforeachVTAM-controlledprinter.
Requiredz/OSInfoprintServerOperationandAdministrationDefineeachprintertoVTAM.
Optional:IftheprinterisnotalreadydefinedtoVTAMz/OSInfoprintServerOperationandAdministrationForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerpublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerOperationandAdministrationIPPrintWayVTAMPrinterSupportChapter4.
OS/390Version2Release8Overview105SNMPSubagentDescriptionAnewInfoprintServercomponent,theSimpleNetworkManagementProtocol(SNMP)subagent,providessupportthatletsadministratorsviewprintercharacteristicsandprinterstatusforanyprintercontrolledbyPSFforOS/390.
Also,administratorscanbenotifiedassoonasaninterventionsituationoccursonPSF-controlledprinters.
WhatThisChangeAffectsThissupportaffectsthefollowingareasofInfoprintServerprocessing.
AreaConsiderationsAdministrationTheadministratorcanrequestSNMPreportingintheFSAdefinitioninthePrinterInventoryforaPSFprinter.
Bydefault,SNMPreportingisnotenabled.
ApplicationDevelopmentNone.
AuditingNoneCustomizationThesystemprogrammermustcustomizetheInfoprintServerSNMPsubagent.
See"Dependencies"formoreinformation.
Thesystemprogrammercan,optionally,automatethestartoftheSNMPsubagent.
DiagnosisThediagnosticianmightneedtotracethez/OSSNMPagentorPSFforOS/390tohelpIBMdiagnoseerrors.
GeneralUserNone.
OperationsTheoperatormuststartthez/OSSNMPagentandthenstarttheInfoprintServerSNMPsubagentunlessyourinstallationhasautomatedthestartofthesubagent.
InterfacesSeeTable12onpage111andTable36onpage139.
DependenciesTousetheInfoprintServerSNMPsubagent,yourinstallationmustalsodothefollowing:vCustomizeandstartthez/OSSNMPagentbeforestartingthesubagent.
vInstallandcustomizeanSNMPmanagerthatsupportstheprinterMIBandmultipleprintersdefinedwithoneIPaddress.
vCustomizePSFforOS/390tousethePrinterInventoryandenableSNMPreportinginFSAdefinitionsforPSFprinters.
MigrationTasksThefollowingmigrationtasksareassociatedwiththisenhancement.
Requiredtasksapplytoallinstallationsthatenablethisfunction.
Optionaltasksapplyonlywhenthelistedconditionismet.
Formoredetailsontheproceduresassociatedwithatask,seethereferencelisted.
TaskConditionReferenceInformationCustomizetheInfoprintServerSNMPsubagent,thez/OSSNMPagent,andanSNMPmanager.
Requiredz/OSInfoprintServerCustomizationSNMPSubagent106z/OSV1R2.
0InfoprintServerMigrationTaskConditionReferenceInformationCustomizePSFforOS/390tousethePrinterInventory.
RequiredPSFforOS/390&z/OS:CustomizationRequestSNMPreportinginPSFforOS/390FSAdefinitions.
RequiredPSFforOS/390&z/OS:CustomizationStartthez/OSSNMPagentandthenstarttheInfoprintServerSNMPsubagent.
Requiredz/OSInfoprintServerOperationandAdministrationUsediagnosticproceduresfortheSNMPsubagent.
Optional:Ifproblemsarisez/OSInfoprintServerMessagesandDiagnosisForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServer,PSFforOS/390,andSecureWaypublications:vz/OSInfoprintServerCustomizationvz/OSInfoprintServerOperationandAdministrationvz/OSInfoprintServerMessagesandDiagnosisvPSFforOS/390&z/OS:Customizationvz/OSCommunicationsServer:IPConfigurationReferenceSNMPSubagentChapter4.
OS/390Version2Release8Overview107PSFforOS/390StartupEnhancementsDescriptionTheadministratorcannowspecifyPSFforOS/390customizationinformationinthePrinterInventoryinsteadofinPSFstartupproceduresandPSFexitroutines.
Tousethisfunction,theadministratormustcreatefunctionalsubsystem(FSS)andfunctionalsubsystemapplication(FSA)definitionsinthePrinterInventory.
ThisfunctionletsthePSFadministratorchangeprinterinformationwithoutrestartingalloftheprintersinthefunctionalsubsystem(FSS).
WhatThisChangeAffectsThissupportaffectsPSFforOS/390processing.
RefertothePSFforOS/390publicationlistedbelowformigrationinformation.
DependenciesPSFforOS/390mustbecustomizedtousethePrinterInventory.
CoexistenceConsiderationsRefertothePSFforOS/390publicationlistedbelowformigrationinformation.
MigrationTasksRefertothePSFforOS/390publicationlistedbelowformigrationinformation.
ForMoreInformationFormoredetailedinformationaboutthissupport,refertothefollowingInfoprintServerandPSFforOS/390publications:vz/OSInfoprintServerOperationandAdministrationvPSFforOS/390&z/OS:CustomizationPSFforOS/390StartupEnhancements108z/OSV1R2.
0InfoprintServerMigrationChapter5.
SummaryofInterfaceChangesThischaptersummarizesthenewandchangedinterfacesforInfoprintServerintroducedinOS/390Version2Release8andinz/OSVersion1Release2.
ForInformationAbout:SeePage:ApplicationProgrammingInterface(API)Functions110ConfigurationFiles111DataSetsandFiles112EnvironmentVariables113Exits113FileSystems(/etcand/var)122Filters122InfoprintPortMonitorforWindows124ISPFPanels124JCLParameters(OUTPUTandDDStatements)126JobAttributes128Messages129NetSpoolOperatorCommands131SMFType6Record132PIDUPrinterAttributes130StartupProcedures133SYS1.
MACLIBMembers134SYS1.
PROCLIBMembers135SYS1.
SAMPLIBMembers135TSOLogonProcedure137/usr/lpp/Printsrv/samples/Directory138z/OSUNIXCommands139CopyrightIBMCorp.
19992002109||||||||||ApplicationProgrammingInterface(API)FunctionsTable12onpage111liststhefunctionsinthenewInfoprintServerapplicationprogramminginterface(API).
Thesefunctionsaredefinedinheaderfileaopapi.
h.
Refertoz/OSInfoprintServerCustomizationfordetailedinformationaboutthesefunctions.
Table11.
SummaryofChangestoApplicationProgrammingInterfaceAPIFunctionReleaseDescriptionRelatedSupportAbortPrintFileOS/390V2R8New:TerminatesanInfoprintServerprintjob.
PrintInterfaceAPIBeginEnumJobsOS/390V2R8New:BeginsanenumerationofInfoprintServerprintjobsforaprinter.
PrintInterfaceAPIBeginEnumPrintersOS/390V2R8New:BeginsanenumerationofInfoprintServerprinters.
PrintInterfaceAPIBufferSizeRequiredOS/390V2R8New:Returnstherequiredbuffersizeafterabufferoverflowerror.
PrintInterfaceAPICancelJobOS/390V2R8New:CancelsanInfoprintServerprintjob.
PrintInterfaceAPIClosePrintFileOS/390V2R8New:ClosesanInfoprintServerprintjob.
PrintInterfaceAPICreatePrintFileOS/390V2R8New:CreatesanInfoprintServerprintjob.
PrintInterfaceAPIEndEnumJobsOS/390V2R8New:EndsanenumerationofInfoprintServerprintjobsforaprinter.
PrintInterfaceAPIEndEnumPrintersOS/390V2R8New:EndsanenumerationofInfoprintServerprinters.
PrintInterfaceAPIEnumJobsOS/390V2R8New:ReturnsanenumerationofInfoprintServerprintjobsforaprinter.
PrintInterfaceAPIEnumPrintersOS/390V2R8New:ReturnsanenumerationofInfoprintServerprinters.
PrintInterfaceAPIErrorNumberOS/390V2R8New:ReturnstheAPIerrorcode.
PrintInterfaceAPIErrorStringOS/390V2R8New:ReturnsapointertoanAPIerrormessage.
PrintInterfaceAPIGetJobInfoOS/390V2R8New:ReturnsstatusofanInfoprintServerprintjob.
PrintInterfaceAPIGetPrinterInfoOS/390V2R8New:ReturnsinformationaboutanInfoprintServerprinter.
PrintInterfaceAPIInitAPIOS/390V2R8New:InitializestheAPI.
PrintInterfaceAPIReleaseTransformOS/390V2R8New:EndstheconnectionbetweenatransformfilterandtheTransformManager.
PrintInterfaceAPIRequestTransformOS/390V2R8New:ConnectsatransformfiltertotheTransformManager.
PrintInterfaceAPISetTerminationHandlerOS/390V2R8New:Registersafunctiontobecalledatprogramtermination.
PrintInterfaceAPITermAPIOS/390V2R8New:TerminatestheAPI.
PrintInterfaceAPIWritePrintFileOS/390V2R8New:WritesdatatoanInfoprintServerprintjob.
PrintInterfaceAPIInterfaceChanges110z/OSV1R2.
0InfoprintServerMigrationConfigurationFilesTable12identifieschangestoInfoprintServerconfigurationfiles.
Refertoz/OSInfoprintServerCustomizationfordetailedinformationabouttheseconfigurationfiles.
Table12.
SummaryofChangestoConfigurationFilesConfigurationFileReleaseDescriptionRelatedSupportaopd.
confOS/390V2R8Updated:Thisoptionalfilecontainsthefollowingnewandchangedattributes:vNew:inventory,anoptionalattributeusedtochangethedefaultname(AOP1)forthePrinterInventory.
vNew:ipp-port-number,anoptionalattributeusedtochangethedefaultport(port631)fortheInternetPrintingProtocolserver.
vUpdated:server-portisreplacedbylpd-port-number,anoptionalattributeusedtochangethedefaultport(port515)fortheInfoprintServerlpd;howeverserver-portisstillaccepted.
vNew:snmp-community,anoptionalattributeusedtochangethedefaultcommunitynameusedbytheInfoprintServerSNMPsubagent.
vNew:start-daemons,anoptionalattributethatletsyouspecifywhichInfoprintServerdaemonsaretobestarted.
Bydefault,thesamedaemonsarestartedasinpreviousreleases(aopdandaoplpd).
PrinterInventory,PrintInterfaceIPPServer,SNMPSubagent,andTransforms.
z/OSV1R2Updated:Thenewsubdvalueforthestart-daemonsattributeletsyoustartthePrintInterfacesubsystemdaemon.
PrintInterfaceSubsystemforBatchApplicationsaopsapd.
confOS/390V2R8New:ThisSAPCallbackdaemonconfigurationfileisrequiredifyouusethePrintInterfaceSAPOutputManagementSystem(SAP)withtheSAPR/3ApplicationServerforz/OS.
PrintInterfaceSAPOutputManagementSystemaopxfd.
confOS/390V2R8New:ThistransformconfigurationfileisrequiredifyouuseInfoprintServerTransformstotransformPCL,PDF,orPostScriptdatatoAFPformat.
ItisalsorequiredifyouuseInfoprintServerTransformstotransformAFPorlinedatatoPCL,PDF,orPostScriptformat.
Transforms,AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsOS/390V2R8Updated:Youcanspecifythefollowingnewenvironmentvariablesinthisfile:vAOP_CUTSHEETfortheAFPtoPCL,AFPtoPDF,andAFPtoPostScripttransformsvAOP_FLATEfortheAFPtoPDFtransformvAOP_PJLfortheAFPtoPCLtransformTheAOP_PAPERenvironmentvariablefortheAFPtoPCL,AFPtoPDF,andAFPtoPostScripttransformsnowacceptstheA5value.
TransformEnhancementsInterfaceChangesChapter5.
SummaryofInterfaceChanges111||||||||||||||||||Table12.
SummaryofChangestoConfigurationFiles(continued)ConfigurationFileReleaseDescriptionRelatedSupportbarcode.
tabdefcp.
tabfonts.
tabimage.
tabpagedef.
tabprinter.
tabxxxx0000.
tabOS/390V2R8New:ThesetransformconfigurationfilesarerequiredifyouuseInfoprintServerTransformstotransformSAPdatatoAFPformat.
TransformsUserInitpreload.
psOS/390V2R8New:ThesetransformconfigurationfilesarerequiredifyouuseInfoprintServerTransformstotransformPostScriptdatatoAFPformat.
TransformsDataSetsandFilesTable13identifieschangestodatasetsandfilesusedbyInfoprintServerV2R8.
Refertoz/OSInfoprintServerOperationandAdministrationfordetailedinformationaboutthePrinterInventory.
Refertoz/OSInfoprintServerCustomizationfordetailedinformationabouttheIPPrintWaytransmission-queueandmessage-logdatasets.
Table13.
SummaryofChangestoDataSetsDataSetReleaseDescriptionRelatedSupportInfoprintServerPrinterInventoryOS/390V2R8New:HFSfilesthatcontainsinformationaboutprintersandfunctionalsubsystems.
PrinterInventoryIPPrintWayRouting(ANF.
ROUTING)OS/390V2R8Deleted:Thisdatasetisobsolete,replacedbytheInfoprintServerPrinterInventory.
PrinterInventoryIPPrintWayOptions(ANF.
OPTIONS)OS/390V2R8Deleted:Thisdatasetisobsolete,replacedbytheInfoprintServerPrinterInventory.
PrinterInventoryIPPrintWayTransmissionQueue(ANF.
QUEUE)OS/390V2R8Updated:Theformatofthisdatasethaschangedandthedatasetmustberecreated.
TheadministratornowusesInfoprintServerISPFpanelstoviewentries.
PrinterInventoryIPPrintWayMessage-Log(ANF.
MSGFILE)OS/390V2R8Updated:TheadministratornowusesInfoprintServerISPFpanelstoviewIPPrintWaymessagesusingtheautomaticbrowsefeature.
PrinterInventoryNetSpoolPage-FormatTable(APIPPPFT)OS/390V2R8Deleted:Thisdatasetisobsolete,replacedbytheInfoprintServerPrinterInventory.
PrinterInventoryNetSpoolEnd-of-FileRulesTable(APIPPEFT)OS/390V2R8Deleted:Thisdatasetisobsolete,replacedbytheInfoprintServerPrinterInventory.
PrinterInventoryNetSpoolPrintCharacteristicsOS/390V2R8Deleted:Thisdatasetisobsolete,replacedbytheInfoprintServerPrinterInventory.
PrinterInventoryPrintInterfacePrinterInventoryOS/390V2R8Deleted:TheseHFSfilesareobsolete,replacedbytheInfoprintServerPrinterInventory.
PrinterInventoryInterfaceChanges112z/OSV1R2.
0InfoprintServerMigrationEnvironmentVariablesTable14identifieschangestoenvironmentvariablesusedbyInfoprintServerinOS/390V2R8.
Refertoz/OSInfoprintServerCustomizationfordetailedinformationabouttheseenvironmentvariables.
Table14.
SummaryofChangestoEnvironmentVariablesEnvironmentVariableReleaseDescriptionRelatedSupportAOPMAILERz/OSV1R21New:Anoptionalvariabletospecifythelocationofthez/OSUNIXsendmailexecutablefile.
IPPrintWayE-mailSupportAOPOPTIONSOS/390V2R8New:Anoptionalvariabletospecifyjobattributesusedbythelpcommand.
PrintInterfacelpCommandEnhancementsAOP_SAP2AFP_RESOURCESOS/390V2R8New:AnoptionalvariabletochangethedefaultSAPtoAFPtransformresourcesdirectory.
TransformsAOPSAPD_CONFOS/390V2R8New:Anoptionalvariabletochangethedefaultpathfortheaopsapd.
confconfigurationfile.
PrintInterfaceSAPOutputManagementSystemAOPXFD_CONFOS/390V2R8New:Anoptionalvariabletochangethedefaultpathfortheaopxfd.
confconfigurationfile.
TransformsCLASSPATHOS/390V2R8New:AnoptionalvariabletochangethedefaultdirectoryforfilesrequiredbythePrintInterfaceIPPserver.
PrintInterfaceIPPServerNLSPATHOS/390V2R8Updated:IdentifiesthelocationoftheInfoprintServermessagecatalog.
TheInfoprintServerEnglishmessagecataloghasbeenmovedtodirectory/usr/lpp/Printsrv/En_US/%Nfrom/usr/lpp/Printsrv/en_US/%N.
(NotethechangefromalowercaseetoanuppercaseEinEn_US.
)PrinterInventory1.
ThesechangeshavebeenrolledbacktoOS/390V2R8andlaterreleases.
ExitsTable15identifieschangestoNetSpoolandIPPrintWayexitroutines.
Refertoz/OSInfoprintServerCustomizationfordetailedinformationabouttheseexits.
Note:DuetochangesintheIPPrintWaydataarea,ANFUEXTP,allIPPrintWayexitsmustbereassembledwhenyoumigratetoOS/390V2R8throughz/OSV1R1.
Table15.
SummaryofChangestoExitRoutinesExitNameReleaseDescriptionRelatedSupportNetSpoolTransparentDataExit(APIPPTD2)andBeginningofFileExitforSCSData(APIPPTD1)OS/390V2R8Updated:TheseexitsmustnowbelinkeditedintoanAPF-authorizedlibrary.
PrinterInventoryz/OSV1R2Updated:FieldS2FLAGSisnewintheNetSpoolAPIPP1X2macro,whichmapstheinputcontrolblocktoNetSpoolexits.
ThisfieldidentifiestheLUtypeoftheVTAMsessionandthetypeofoutputdatastreamNetSpoolcreates(lineorPCLdatastream).
NetSpoolPCLConversionInterfaceChangesChapter5.
SummaryofInterfaceChanges113|||||||||||||||Table15.
SummaryofChangestoExitRoutines(continued)ExitNameReleaseDescriptionRelatedSupportNetSpoolBeginningofFileExitfor3270DataStreams(APIUBF3)z/OSV1R2New:ThisexitletsyouaddPCLcommandsandtexttothebeginningofeachoutputdataset.
NetSpoolExitEnhancementsNetSpoolGraphicEscapeExit(APIUGEX)z/OSV1R2New:ThisexitletsyoureplaceGraphicEscapecharacterswithotherprintablecharacters.
NetSpoolExitEnhancementsInterfaceChanges114z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||Table15.
SummaryofChangestoExitRoutines(continued)ExitNameReleaseDescriptionRelatedSupportIPPrintWayRouting(ANFUXRTG)OS/390V2R8Updated:TheformatoftheANFUEXTPdataareaischangedandthecontentsofthefieldshavechanged:vUpdated:FieldXTPIPADRcancontaintheIPaddress,theURL,ortheVTAMLUnameofthetargetprinter,dependingonthetransmissionprotocolIPPrintWayuses.
vUpdated:FieldXTPKEY(samefieldasXTPDEST,XTPCLASS,andXTPFORMS)containseitheraprinterdefinitionnameortheDEST,CLASS,andFORMSassociatedwiththeprinterdefinition.
XTPDEST,XTPCLASS,orXTPFORMScontainsblanksifthevalueisblankintheprinterdefinition.
vUpdated:FieldXTPPRTQUcancontaintheprintqueuename,portnumber,ortheVTAMlogonmodeentryname,dependingonthetransmissionprotocolIPPrintWayuses.
vUpdated:FieldXTPOPTNMcontainsthenameofcomponents,insteadofanoptionsentryname.
vUpdated:FieldXTPOLENisnolongerinputtothisexit.
vNew:FieldXTPOPTNScontainsIPPrintWayformattingandtransmissionoptionsforthedataset.
vNew:FieldXTP_ROUTING_KEY_TYPEidentifiesthecontentsoffieldXTPKEYandisinputtotheexit.
vNew:FieldXTP_ADDR_TYPEidentifiesthecontentsoffieldsXTPIPADRandXTPPRTQUandisinputtotheexit.
vDeleted:FieldXTPLPROPnolongercontainsformattingandtransmissionoptions.
PrinterInventory,IPPrintWayPrinterSelectionwithFSSDATAJCLParameter,IPPrintWayIPPClient,andIPPrintWayVTAMPrinterSupportz/OSV1R21Updated:ThecontentsofthefollowingfieldsincontrolblockANFUEXTPhavechanged:vUpdated:FieldXTP_ADDR_TYPEcontainsavalueof4ifthee-mailprotocolisselectedintheprinterdefinition.
vUpdated:FieldXTPIPADRcontainstherecipiente-mailaddresseslistiffieldXTP_ADDR_TYPEcontainsavalueof4.
IPPrintWayE-mailSupportz/OSV1R21Updated:FieldXTPUSRIDincontrolblockANFUEXTPnowalwayscontainstheuserIDofthejobsubmitterwhenPrintInterfacehasallocatedtheoutputdatasetontheJESspool.
Ifthejobwasoriginallysubmittedfromaremotesystem,thenthisuserIDisfromtheremotesystem.
IPPrintWayResubmitforFilteringEnhancementsInterfaceChangesChapter5.
SummaryofInterfaceChanges115||||||||||||||||||||Table15.
SummaryofChangestoExitRoutines(continued)ExitNameReleaseDescriptionRelatedSupportIPPrintWayBeginDataSetOS/390V2R8Updated:TheformatoftheANFUEXTPdataareaischangedandthecontentsofthefieldshavechanged:vUpdated:FieldXTPIPADRcancontaintheIPaddress,theURL,ortheVTAMLUnameofthetargetprinter,dependingonthetransmissionprotocolIPPrintWayuses.
vUpdated:FieldXTPKEY(samefieldasXTPDEST,XTPCLASS,andXTPFORMS)containseitheraprinterdefinitionnameortheDEST,CLASS,andFORMSassociatedwiththeprinterdefinition.
XTPDEST,XTPCLASS,orXTPFORMScontainsblanksifthevalueisblankintheprinterdefinition.
vUpdated:FieldXTPOPTNMcontainsthenameofcomponents,insteadofanoptionsentry.
vUpdated:FieldXTPOLENisnolongerinputtothisexit.
vNew:FieldXTPOPTNScontainsIPPrintWayformattingandtransmissionoptionsforthedataset.
vUpdated:FieldXTPPRTQUcancontaintheprintqueuename,portnumber,ortheVTAMlogonmodeentryname,dependingonthetransmissionprotocolIPPrintWayuses.
vNew:FieldXTP_ROUTING_KEY_TYPEidentifiesthecontentsofXTPKEYandisinputtotheexit.
vNew:FieldXTP_ADDR_TYPEidentifiesthecontentsoffieldsXTPIPADRandXTPPRTQUandisinputtotheexit.
vNew:FieldXTP_FILTERINGidentifieswhetherIPPrintWayhasresubmittedthedatasettoPrintInterfacesothatatransformfiltercanbeapplied.
vDeleted:FieldXTPLPROPnolongercontainsformattingandtransmissionoptions.
PrinterInventory,IPPrintWayPrinterSelectionwithFSSDATAJCLParameter,IPPrintWayIPPClient,andIPPrintWayTransformFunctionInterfaceChanges116z/OSV1R2.
0InfoprintServerMigrationTable15.
SummaryofChangestoExitRoutines(continued)ExitNameReleaseDescriptionRelatedSupportIPPrintWayBeginDataSetz/OSV1R2Updated:IPPrintWaynowcallsthisexitbeforeprinterinstructionsspecifiedintheDocumentheaderfieldoftheprinterdefinitionareadded.
IPPrintWayExitEnhancementz/OSV1R21Updated:ThecontentsofthefollowingfieldsincontrolblockANFUEXTPhavechanged:vUpdated:FieldXTP_ADDR_TYPEcontainsavalueof4ifthee-mailprotocolisselectedintheprinterdefinition.
vUpdated:FieldXTPIPADRcontainstherecipiente-mailaddresseslistiffieldXTP_ADDR_TYPEcontainsavalueof4.
IPPrintWayE-mailSupportz/OSV1R21Updated:FieldXTPUSRIDincontrolblockANFUEXTPnowalwayscontainstheuserIDofthejobsubmitterwhenPrintInterfacehasallocatedtheoutputdatasetontheJESspool.
Ifthejobwasoriginallysubmittedfromaremotesystem,thenthisuserIDisfromtheremotesystem.
IPPrintWayResubmitforFilteringEnhancementsInterfaceChangesChapter5.
SummaryofInterfaceChanges117||||||||||||||||||||||||||||Table15.
SummaryofChangestoExitRoutines(continued)ExitNameReleaseDescriptionRelatedSupportIPPrintWayRecordOS/390V2R8Updated:TheformatoftheANFUEXTPdataareaischangedandthecontentsofthefieldshavechanged:vUpdated:FieldXTPIPADRcancontaintheIPaddress,theURL,ortheVTAMLUnameofthetargetprinter,dependingonthetransmissionprotocolIPPrintWayuses.
vUpdated:FieldXTPKEY(samefieldasXTPDEST,XTPCLASS,andXTPFORMS)containseitheraprinterdefinitionnameortheDEST,CLASS,andFORMSassociatedwiththeprinterdefinition.
XTPDEST,XTPCLASS,orXTPFORMScontainsblanksifthevalueisblankintheprinterdefinition.
vUpdated:FieldXTPOLENisnolongerinputtothisexit.
vNew:FieldXTPOPTNScontainsIPPrintWayformattingandtransmissionoptionsforthedataset.
vUpdated:FieldXTPPRTQUcancontaintheprintqueuename,portnumber,ortheVTAMlogonmodeentryname,dependingonthetransmissionprotocolIPPrintWayuses.
vNew:FieldXTP_ROUTING_KEY_TYPEidentifiesthecontentsofXTPKEYandisinputtotheexit.
vNew:FieldXTP_ADDR_TYPEidentifiesthecontentsoffieldsXTPIPADRandXTPPRTQUandisnowinputtotheexit.
vDeleted:FieldXTPLPROPnolongercontainsformattingandtransmissionoptions.
PrinterInventory,IPPrintWayPrinterSelectionwithFSSDATAJCLParameter,IPPrintWayIPPClient,andIPPrintWayVTAMPrinterSupportz/OSV1R21Updated:ThecontentsofthefollowingfieldsincontrolblockANFUEXTPhavechanged:vUpdated:FieldXTP_ADDR_TYPEcontainsavalueof4ifthee-mailprotocolisselectedintheprinterdefinition.
vUpdated:FieldXTPIPADRcontainstherecipiente-mailaddresseslistiffieldXTP_ADDR_TYPEcontainsavalueof4.
IPPrintWayE-mailSupportz/OSV1R21Updated:FieldXTPUSRIDincontrolblockANFUEXTPnowalwayscontainstheuserIDofthejobsubmitterwhenPrintInterfacehasallocatedtheoutputdatasetontheJESspool.
Ifthejobwasoriginallysubmittedfromaremotesystem,thenthisuserIDisfromtheremotesystem.
IPPrintWayResubmitforFilteringEnhancementsInterfaceChanges118z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||||Table15.
SummaryofChangestoExitRoutines(continued)ExitNameReleaseDescriptionRelatedSupportIPPrintWayEndDataSetOS/390V2R8Updated:TheformatoftheANFUEXTPdataareaischangedandthecontentsofthefieldshavechanged:vUpdated:FieldXTPIPADRcancontaintheIPaddress,theURL,ortheVTAMLUnameofthetargetprinter,dependingonthetransmissionprotocolIPPrintWayuses.
vUpdated:FieldXTPKEY(samefieldasXTPDEST,XTPCLASS,andXTPFORMS)containseitheraprinterdefinitionnameortheDEST,CLASS,andFORMSassociatedwiththeprinterdefinition.
XTPDEST,XTPCLASS,orXTPFORMScontainsblanksifthevalueisblankintheprinterdefinition.
vUpdated:FieldXTPOPTNMcontainsthenameofcomponentsinsteadofanoptionsentry.
vUpdated:FieldXTPOLENisnolongerinputtothisexit.
vNew:FieldXTPOPTNScontainsIPPrintWayformattingandtransmissionoptionsforthedataset.
vUpdated:FieldXTPPRTQUcancontaintheprintqueuename,portnumber,ortheVTAMlogonmodeentryname,dependingonthetransmissionprotocolIPPrintWayuses.
vNew:FieldXTP_ROUTING_KEY_TYPEidentifiesthecontentsofXTPKEYandisinputtotheexit.
vNew:FieldXTP_ADDR_TYPEidentifiesthecontentsoffieldsXTPIPADRandXTPPRTQUandisinputtotheexit.
vNew:FieldXTP_FILTERINGidentifieswhetherIPPrintWayhasresubmittedthedatasettoPrintInterfacesothatatransformfiltercanbeapplied.
vDeleted:FieldXTPLPROPnolongercontainsformattingandprintingoptions.
PrinterInventory,IPPrintWayPrinterSelectionwithFSSDATAJCLParameter,IPPrintWayIPPClient,IPPrintWayTransformFunction,andIPPrintWayVTAMPrinterSupportInterfaceChangesChapter5.
SummaryofInterfaceChanges119Table15.
SummaryofChangestoExitRoutines(continued)ExitNameReleaseDescriptionRelatedSupportIPPrintWayEndDataSetz/OSV1R2Updated:IPPrintWaynowcallsthisexitafterprinterinstructionsspecifiedintheDocumenttrailerfieldoftheprinterdefinitionareadded.
IPPrintWayExitEnhancementz/OSV1R21Updated:ThecontentsofthefollowingfieldsincontrolblockANFUEXTPhavechanged:vUpdated:FieldXTP_ADDR_TYPEcontainsavalueof4ifthee-mailprotocolisselectedintheprinterdefinition.
vUpdated:FieldXTPIPADRcontainstherecipiente-mailaddresseslistiffieldXTP_ADDR_TYPEcontainsavalueof4.
IPPrintWayE-mailSupportz/OSV1R21Updated:FieldXTPUSRIDincontrolblockANFUEXTPnowalwayscontainstheuserIDofthejobsubmitterwhenPrintInterfacehasallocatedtheoutputdatasetontheJESspool.
Ifthejobwasoriginallysubmittedfromaremotesystem,thenthisuserIDisfromtheremotesystem.
IPPrintWayResubmitforFilteringEnhancementsIPPrintWaySMF(ANFUXSMF)OS/390V2R8Updated:TheformatoftheANFUEXTPdataareaischangedandthecontentsofthefieldshavechanged:vUpdated:FieldXTPIPADRcancontaintheIPaddress,theURL,ortheVTAMLUnameofthetargetprinter,dependingonthetransmissionprotocolIPPrintWayuses.
vUpdated:FieldXTPKEY(samefieldasXTPDEST,XTPCLASS,andXTPFORMS)containseitheraprinterdefinitionnameortheDEST,CLASS,andFORMSassociatedwiththeprinterdefinition.
XTPDEST,XTPCLASS,orXTPFORMScontainsblanksifthevalueisblankintheprinterdefinition.
vUpdated:FieldXTPPRTQUcancontaintheprintqueuename,portnumber,ortheVTAMlogonmodeentryname,dependingonthetransmissionprotocolIPPrintWayuses.
vNew:FieldXTP_ROUTING_KEY_TYPEidentifiesthecontentsofXTPKEYandisinputtotheexit.
vNew:FieldXTP_FILTERINGidentifieswhetherIPPrintWayisresubmittingthedatasettoPrintInterfacesothatatransformfiltercanbeapplied.
vNew:FieldXTP_ADDR_TYPEidentifiesthecontentsoffieldsXTPIPADRandXTPPRTQUandisinputtotheexit.
IPPrintWayPrinterSelectionwithFSSDATAJCLParameter,IPPrintWayIPPClient,IPPrintWayTransformFunction,andIPPrintWayVTAMPrinterSupportz/OSV1R21Updated:FieldXTPUSRIDincontrolblockANFUEXTPnowalwayscontainstheuserIDofthejobsubmitterwhenPrintInterfacehasallocatedtheoutputdatasetontheJESspool.
Ifthejobwasoriginallysubmittedfromaremotesystem,thenthisuserIDisfromtheremotesystem.
IPPrintWayResubmitforFilteringEnhancementsInterfaceChanges120z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||||||||||||||||||||||Table15.
SummaryofChangestoExitRoutines(continued)ExitNameReleaseDescriptionRelatedSupportIPPrintWayMessage(ANFUXMSG)OS/390V2R8Updated:TheformatoftheANFUEXTPdataareaischanged.
Inputandoutputfieldstothisexitareunchanged.
PrinterInventoryIPPrintWayResponseNotification(ANFUXRSP)OS/390V2R8Updated:TheformatoftheANFUEXTPdataareaischangedandthecontentsofthefieldshavechanged:vUpdated:FieldXTPIPADRcancontaintheIPaddress,theURL,ortheVTAMLUnameofthetargetprinter,dependingonthetransmissionprotocolIPPrintWayuses.
vUpdated:FieldXTPKEY(samefieldasXTPDEST,XTPCLASS,andXTPFORMS)containseitheraprinterdefinitionnameortheDEST,CLASS,andFORMSassociatedwiththeprinterdefinition.
XTPDEST,XTPCLASS,orXTPFORMScontainsblanksifthevalueisblankintheprinterdefinition.
vUpdated:FieldXTPOPTNMcontainsthenameofcomponents,insteadofanoptionsentry.
vUpdated:FieldXTPOLENisstillavalidfieldbutisnolongerinputtothisexit.
vNew:FieldXTPOPTNScontainsIPPrintWayformattingandtransmissionoptionsforthedataset.
vUpdated:FieldXTPPRTQUcancontaintheprintqueuename,portnumber,ortheVTAMlogonmodeentryname,dependingonthetransmissionprotocolIPPrintWayuses.
vNew:FieldXTP_ROUTING_KEY_TYPEidentifiesthecontentsofXTPKEYandisinputtotheexit.
vNew:FieldXTP_ADDR_TYPEidentifiesthecontentsoffieldsXTPIPADRandXTPPRTQUandisinputtotheexit.
vDeleted:FieldXTPLPROPnolongercontainsformattingandprintingoptions.
vNew:FieldXTP_FILTERINGidentifieswhetherIPPrintWayhasresubmittedthedatasettoPrintInterfacesothatatransformfiltercanbeapplied.
PrinterInventory,IPPrintWayPrinterSelectionwithFSSDATAJCLParameter,IPPrintWayIPPClient,IPPrintWayTransformFunction,andIPPrintWayVTAMPrinterSupport1.
ThischangehasbeenrolledbacktoOS/390V2R8andlaterreleases.
InterfaceChangesChapter5.
SummaryofInterfaceChanges121|FileSystems—/etcand/varDirectoriesTable16identifieschangestofilesusedbyInfoprintServerinV2R8inthe/etcand/vardirectories.
See"ConfigurationFiles"onpage111forasummaryofthechangestothesefiles.
Refertoz/OSInfoprintServerCustomizationfordetailedinformationaboutthefilesinthesefilesystems.
Table16.
SummaryofChangesto/etcand/varDirectoriesDirectoryReleaseDescriptionRelatedSupport/etc/Printsrv/OS/390V2R8The/etc/Printsrv/directorycontainsthefollowingfiles:vUpdated:/etc/Printsrv/aopd.
confisthedefaultlocationfortheInfoprintServerconfigurationfile;thefilelocationcanbechangedintheAOPCONFenvironmentvariable.
Youcanspecifynewstatementsinthisfile.
vNew:/etc/Printsrv/aopxfd.
confisthedefaultlocationforthenewtransformconfigurationfile;thefilelocationcanbechangedintheAOPXFD_CONFenvironmentvariable.
vNew:/etc/Printsrv/aopsapd.
confisthedefaultlocationforthenewSAPCallbackdaemonconfigurationfile;thefilelocationcanbechangedintheAOPSAPD_CONFenvironmentvariable.
PrinterInventory,PrintInterfaceIPPServer,SNMPSubagent,Transforms,andPrintInterfaceSAPOutputManagementSystem/var/Printsrv/OS/390V2R8The/var/Printsrv/directorycontainsthefollowingsub-directoriesandfiles:vDeleted:/var/Printsrv/printers/isthedefaultsub-directoryforthefilesthatcomprisethePrintInterfaceprinterinventory.
ThesefilesareinputtotheInfoprintServermigrationprogram;otherwise,theyareobsolete.
Youdonotneedtodeletethisdirectory;infact,youmightwanttosaveitforreferencepurposes.
vNew:/var/Printsrv/isthedefaultdirectoryforthePrinterInventory;thedirectorylocationcanbechangedinthebase-directorystatementintheInfoprintServerconfigurationfileaopd.
conf.
PrinterInventoryFiltersTable17onpage123identifieschangestofilterprogramsprovidedbyInfoprintServerandInfoprintServerTransformsinV2R8.
Table18onpage123identifieschangestoinstallation-writenfilterprogramsthatPrintInterfacecancallbeforewritingdatatotheJESspool.
Refertoz/OSInfoprintServerCustomizationfordetailedinformationaboutthesefilters.
InterfaceChanges122z/OSV1R2.
0InfoprintServerMigrationTable17.
SummaryofChangestoFiltersProvidedwithInfoprintServerorInfoprintServerTransformsFilterNameReleaseDescriptionRelatedSupportafp2pcl.
dllOS/390V2R8New:TransformslinedataanddatainAFPformat(MO:DCA-P)toPCLformatonthez/OSsystem;providedbytheAFPtoPCLTransformfeatureofInfoprintServerTransforms.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsafp2pdf.
dllOS/390V2R8New:TransformslinedataanddatainAFPformat(MO:DCA-P)toPDFformatonthez/OSsystem;providedbytheAFPtoPDFTransformfeatureofInfoprintServerTransforms.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsafp2ps.
dllOS/390V2R8New:TransformslinedataanddatainAFPformat(MO:DCA-P)toPostScriptformatonthez/OSsystem;providedbytheAFPtoPostScriptTransformfeatureofInfoprintServerTransforms.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsaoprform.
dllOS/390V2R8New:TransformsdataremotelyusingInfoprintManagerforAIXorPSFforAIX.
PrintInterfaceRemoteTransformsz/OSV1R21New:The-qoptionletsyouspecifytransformattributesfortheInfoprintManagerPostScriptandPDFtoAFPcolortransform.
Updated:The-aoptionletsyouspecifythefs45valuetocreateimagesintheformatrequiredbytheIBMInfoprintColor130Plusprinter.
PrintInterfaceRemoteTransformSupportforIBMInfoprintColor130PlusPrinterlpd_compat.
soOS/390V2R8New:Providesfunctionthatissimilartothez/OSTCP/IPLPD.
PrintInterfaceLPDCompatibilityFilterpcl2afp.
dllOS/390V2R8New:TransformsPCLdatatoAFPformat(MO:DCA-P)onthez/OSsystem;providedbyInfoprintServerTransforms.
Transformsps2afp.
dllOS/390V2R8New:TransformsPostScriptandPDFdatatoAFPformat(MO:DCA-P)onthez/OSsystem;providedbyInfoprintServerTransforms.
Transformssap2afp.
dllOS/390V2R8New:TransformsSAPdatatoAFPformat(MO:DCA-P)onthez/OSsystem;providedbyInfoprintServerTransforms.
Transforms1.
ThischangehasbeenrolledbacktoOS/390V2R8andlaterreleases.
Table18.
SummaryofChangestoInstallation-WrittenFiltersTypeofFilterReleaseDescriptionRelatedSupportDLLfilterOS/390V2R8Changed:ThenameofthefiletobeprintedandthenameoftheprinterdefinitionarenowpassedasinputtoDLLfilters.
ADLLfiltercanalsorequestthatoneormoreInfoprintServerjobattributesbepassedasinput,andcannowsetanyjobattributethatisnotsetbythejobsubmitter.
PrintInterfaceFilterEnhancementsUNIXfilterOS/390V2R8New:AninstallationcannowwriteaUNIX-stylefilterprograminsteadofaDLL-stylefilter.
AUNIXfiltercanperformthesamefunctionsasaDLLfilter;however,aDLLfiltercannotsetjobattributes.
PrintInterfaceFilterEnhancementsInterfaceChangesChapter5.
SummaryofInterfaceChanges123|||||||||||||InfoprintPortMonitorforWindowsTable19identifieschangestotheInfoprintPortMonitorforWindows.
Refertoz/OSInfoprintServerUser'sGuidefordetailedinformationabouttheportmonitor.
Table19.
SummaryofChangestotheInfoprintPortMonitorforWindowsInfoprintPortMonitorOptionReleaseDescriptionRelatedSupportOptionsoptionOS/390V2R8New:ThisoptiondisplaysthenewInfoprintPortMonitorOptionsdialog,whichletsyouspecifyinformationforaseparatorsheetandotherInfoprintServerjobattributes.
PrintInterfaceInfoprintPortMonitorforWindowsEnhancementsUnattendedmodeoptionz/OSV1R21New:ThisoptionindicatesthataprinteratanInfoprintportisusedbyWindowsusersonothersystems.
Whenselected,theInfoprintPortMonitordoesnotdisplayerrormessagesthatrequirearesponse.
PrintInterfaceInfoprintPortMonitorforWindowsEnhancements1.
ThischangehasbeenrolledbacktoOS/390V2R8andlaterreleases.
InfoprintServerISPFPanelsTable20identifieschangestotheISPFpanelsforInfoprintServer.
TheInfoprintServerISPFpanelsarenewinOS/390V2R8;however,someofthefieldnamesarethesameasinthepreviousPrintInterfaceandIPPrintWayISPFpanels.
SeeAppendixB,"MigrationTables"onpage169fortablesthatshowhowoldISPFpanelfieldscorrespondtonewISPFpanelfields.
Alsorefertoz/OSInfoprintServerOperationandAdministrationforinformationaboutISPFpanelfields,andusetheonlinehelpintheInfoprintServerISPFpanelsfordetailedinformationabouteachfield.
Table20.
SummaryofChangestoISPFPanelsISPFPanelsReleaseDescriptionRelatedSupportInfoprintServerOS/390V2R8InfoprintServerISPFpanelsconsistofnewpanelsandalsosomeupdatedIPPrintWayISPFpanels:vNew:TheInfoprintServerISPFpanelslettheadministratorcreateandmanageprinterdefinitions,printerpooldefinitions,FSSdefinitionsandFSAdefinitionsinthePrinterInventory.
vUpdated:TheIPPrintWaytransmission-queuepanelscontainnewandupdatedfieldsandnewpanels.
Newfieldsdisplaytheprinterdefinitionname,thetransmissionprotocol,theURLofthetargetprinter,andtheVTAMLUnameandlogonmodename.
NewpanelsdisplaytheIPPrintWayformattingandtranslationoptionsusedtotransmitthedataset.
vUpdated:TheadministratornowspecifiesthenameoftheIPPrintWaymessage-logdatasetontheInfoprintServerConfigurationpanel.
PrinterInventoryInterfaceChanges124z/OSV1R2.
0InfoprintServerMigration|||||||||||||||||||||||||||||||||Table20.
SummaryofChangestoISPFPanels(continued)ISPFPanelsReleaseDescriptionRelatedSupportIPPrintWayOS/390V2R8Deleted:ThenewInfoprintServerISPFpanelsreplacetheIPPrintWaypanels.
PrinterInventoryPrintInterfaceOS/390V2R8Deleted:ThenewInfoprintServerISPFpanelsreplacethePrintInterfacepanels.
PrinterInventoryPrinterDefinitionpanelsOS/390V2R8New:TheResubmitforfilteringfieldenablestheIPPrintWaytransformfunction.
IPPrintWayTransformFunctionvNew:ThePrinterLUnamefieldletsyouspecifytheLUnameoftheprinterfortheIPPrintWayVTAMprotocol.
vNew:ThePrinterlogmodefieldletsyouspecifytheVTAMlogonmodenamefortheIPPrintWayVTAMprotocol.
IPPrintWayVTAMPrinterSupportz/OSV1R2vNew:TheOptimizecopiesfieldletsyoucontrolhowIPPrintWaytransmitsfileswhenprintingcopiesofadataset.
vUpdated:TheMaximumcopiesfieldletsyouspecifythemaximumnumberofcopiesforjobsthatIPPrintWayhandles.
IPPrintWayCopySupportforLANPrintersvUpdated:TheFormattingfieldletsyouselectanewvalue,ConverttoPCL.
TheStandardvalueisnowcalledConverttoline.
vNew:TheLinedensityfieldletsyouspecifythenumberoflinesperinchwhenNetSpoolconvertsdatatoPCLformat.
vNew:TheOrientationfieldletsyouspecifyportraitorlandscapeorientationwhenNetSpoolconvertsdatatoPCLformat.
vNew:ThePrintdensityfieldletsyouspecifythenumberofcharactersperinchwhenNetSpoolconvertsdatatoPCLformat.
vNew:TheSCSautomaticpageorientationfieldletsyourequestthatNetSpoolautomaticallydeterminetheappropriatepageorientation,portraitorlandscape,foreachpage.
NetSpoolPCLConversionvUpdated:TheCopiesfieldletsyouspecifyavalueupto32640.
vUpdated:TheMaximumcopiesfieldletsyouspecifyavalueupto32640.
PrintInterface>255CopiesSupportInterfaceChangesChapter5.
SummaryofInterfaceChanges125|||||||||||||||||||||||||||||||||||||||||Table20.
SummaryofChangestoISPFPanels(continued)ISPFPanelsReleaseDescriptionRelatedSupportPrinterDefinitionpanelsz/OSV1R21vNew:ThenewE-mailProtocolpanelletsyouspecifyalistofe-mailaddressesintheE-mailaddressesfield.
vUpdated:TheIPPrintWayNoneformattingoptionnowapplieswhenyouselecttheIPPrintWayVTAMprotocol.
vUpdated:TheChooseaDefinitionTypeandProtocolpanelnowletsyouselecttheIPPrintWayE-mailProtocol.
IPPrintWayE-mailSupportvNew:TheVTAMProtocolpanelnowdisplaystheSaveastransparentdatafield.
vUpdated:TheIPPrintWaynoneformattingoptionnowapplieswhenyouselecttheIPPrintWayVTAMprotocol.
vUpdated:TheDeleteformfeedfieldnowapplieswhenyouselecttheIPPrintWayVTAMprotocol.
vUpdated:TheLineterminationfieldnowapplieswhenyouselecttheIPPrintWayVTAMprotocol.
IPPrintWayEnhancementsforPrintingtoVTAMPrintersNew:TheIPPrintWayOptionspanelnowdisplaystheConnectiontimeoutfield.
IPPrintWayTCP/IPConnectionTimeoutEnhancementIPPrintWayQueuepanelsz/OSV1R2Updated:ActionvaluesSandLnowletyouquerythestatusoftheprinter.
IPPrintWayQueryPrinterStatusPSFforOS/390FSADefinitionpanelsz/OSV1R21New:TheRetainedResourceCountsfieldsletyouspecifythenumberofresourcesthatPSFforOS/390istoretaininstoragebetweenprintjobs.
PSFforOS/390FSADefinitionEnhancements1.
ThesechangeshavebeenrolledbacktoOS/390V2R8andlaterreleases.
JCLParametersonOUTPUTandDDStatementsTable21liststhechangestotheparametersausercanspecifyonanOUTPUTJCLstatementwhenprintingtoaprintercontrolledbyIPPrintWayorwhenusingthePrintInterfacesubsystem.
Refertoz/OSInfoprintServerUser'sGuidefordetailedinformationabouttheseparameters.
Table21.
SummaryofChangestoParametersonanOUTPUTJCLStatementParameter(OUTPUTstatement)ReleaseDescriptionRelatedSupportAFPparameters1OS/390V2R8Updated:AusercannowspecifyAFPparametersonanOUTPUTJCLstatementwhentransformingAFPdatatoPCL,PostScript,orPDFformat.
TheAFPtoPCL,AFPtoPDF,andAFPtoPostScripttransformsusetheseparameters.
TheIPPrintWayTransformfunctionmustbeenabledintheprinterdefinition(selecttheResubmitforfilteringfield).
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransforms,IPPrintWayTransformFunctionInterfaceChanges126z/OSV1R2.
0InfoprintServerMigration|||||||||||||||||||||||||||||||||||||||||||||||||||||Table21.
SummaryofChangestoParametersonanOUTPUTJCLStatement(continued)Parameter(OUTPUTstatement)ReleaseDescriptionRelatedSupportDEFAULT=YESz/OSV1R2New:ThePrintInterfacesubsystemusesonlythefirstdefaultOUTPUTJCLstatementinthejobstepor,ifnoneisspecified,thefirstdefaultOUTPUTJCLstatementinthejob.
PrintInterfaceSubsystemforBatchApplicationsDEST,CLASS,FORMSOS/390V2R8Updated:TheusercannowselectanIPPrintWayprinterbyspecifyingoneoftheseparameters(DEST,CLASS,orFORMS)oracombinationoftwoorthreeoftheseparameters.
Previously,IPPrintWayrequiredthatallthreeparameters(CLASS,DEST,andFORMS)matcharoutingentryintheIPPrintWayroutingdataset.
IPPrintWayExtendedRoutingCriteriaz/OSV1R2Updated:WhenthePrintInterfacesubsystemisused,theusercannotselectanIPPrintWayprinterbyspecifyingDEST,CLASS,orFORMS.
Theusermustinsteadspecifytheprinterdefinitionname.
PrintInterfaceSubsystemforBatchApplicationsDEST=IP,PRTQUEUE,PORTNOOS/390V2R8Updated:TheusercanspecifytheseparameterswiththenewFSSDATA=printerparametertooverridetheIPaddressintheprinterdefinitionforthetargetprinter.
IPPrintWayPrinterSelectionwithFSSDATAJCLParameterOS/390V2R8Updated:Theusercannotspecifytheseparameterswhentheresubmitforfilteringfunctionisused.
IPPrintWayTransformFunctionFSSDATA=printerOS/390V2R8New:ThisparameterletsusersselecttheIPPrintWayprinterbyspecifyingthenameoftheprinterdefinitioninthePrinterInventory.
IPPrintWayPrinterSelectionwithFSSDATAJCLParameterGROUPIDOS/390V2R8Updated:Whentheresubmitforfilteringfunctionisused,thedatasetisplacedinaseparateJESoutputsubgroup,regardlessofthevaluespecifiedinthisparameter.
IPPrintWayTransformFunctionz/OSV1R2Updated:WhenthePrintInterfacesubsystemisused,thedatasetisplacedinaseparateJESoutputsubgroup,regardlessofthevaluespecifiedinthisparameter.
PrintInterfaceSubsystemforBatchApplicationsJESNEWSz/OSV1R2New:WhenthePrintInterfacesubsystemisused,JESNEWSisignored.
PrintInterfaceSubsystemforBatchApplicationsPRTOPTNSOS/390V2R8Updated:UserscanspecifythenameofoneormorecomponentsinthePrinterInventory.
ThecomponentscontaintheformattingandtransmissionoptionsthatIPPrintWayusestotransmitthedatasettotheremoteprinter.
Previously,usersspecifiedthenameofanoptionsentryintheIPPrintWayoptionsdataset.
PrinterInventory1.
AFPparametersare:CHARS,DUPLEX,FCB,FORMDEF,INTRAY,OUTBIN,OFFSETXB,OFFSETXF,OFFSETYB,OFFSETXB,OVERLAYB,OVERLAYF,PAGEDEF,PRMODE,TRC,UCS,USERLIBTable22onpage128liststhechangestotheparametersausercanspecifyonaDDJCLstatementwhenusingthePrintInterfacesubsystem.
Refertoz/OSInfoprintServerUser'sGuidefordetailedinformationabouttheseparameters.
InterfaceChangesChapter5.
SummaryofInterfaceChanges127||||||||||||||||||||||||||||||||||||||||||||||Table22.
SummaryofChangestoParametersonaDDJCLStatementParameter(DDstatement)ReleaseDescriptionRelatedSupportBURST,CHARS,COPIES,DCB,DSNAME,FCB,FLASH,UCSz/OSV1R2New:ThePrintInterfacesubsystemsupportstheseparametersoftheDDJCLstatement.
PrintInterfaceSubsystemforBatchApplicationsDSNAMEz/OSV1R2New:ThePrintInterfacesubsystemrequiresformat:&&dsname.
PrintInterfaceSubsystemforBatchApplicationsOUTPUTz/OSV1R2New:ThePrintInterfacesubsystemusesonlythefirstreferencecodedintheOUTPUTparameter;otherreferencesareignored.
PrintInterfaceSubsystemforBatchApplicationsSEGMENT,SYSOUTz/OSV1R2New:TheseparametersarenotallowedwhenyouusethePrintInterfacesubsystem.
PrintInterfaceSubsystemforBatchApplicationsSUBSYSz/OSV1R2New:AusercannowspecifytheSUBSYSparametertorequestthatthePrintInterfacesubsystemprocessthedataset.
ThesubsystemletsyouspecifythefollowingsubparametersontheSUBSYSstatement:vNameofthesubsystem(requiredparameter)vNameoftheprinterdefinitioninthePrinterInventoryvInfoprintServerjobattributesPrintInterfaceSubsystemforBatchApplicationsAllparametersoftheDDJCLstatementexceptthoselistedinthistable.
z/OSV1R2New:TheseparametersareignoredwhenyouusethePrintInterfacesubsystem.
PrintInterfaceSubsystemforBatchApplicationsJobAttributesTable23liststhechangestotheInfoprintServerjobattributesausercanspecifywhensubmittingaprintjobtoInfoprintServer.
Refertoz/OSInfoprintServerUser'sGuidefordetailedinformationaboutthesejobattributes.
Table23.
SummaryofChangestoJobAttributesJobAttributeReleaseDescriptionRelatedSupportaddress-textOS/390V2R8New:Thisnewattributecanbeusedinsteadoftheaddress1-text,address2-text,address3-text,andaddress4-textattributes;however,allpreviousaddressattributesarestillsupported.
PrintInterfacelpCommandEnhancementscharsOS/390V2R8Updated:Thisattributenowrequiresthatasetoffontnamesbeenclosedinbracesinsteadofsingleordoublequotationmarks.
PrintInterfacelpCommandEnhancementscopiesz/OSV1R2Updated:Thisattributenowletsyouspecifyupto32640copies.
PrintInterface>255CopiesSupportfilter-optionsOS/390V2R8New:Thisattributeletstheuserspecifyoptionsusedbythetransformfilters,theLPDcompatibilityfilter,andbyinstallation-writtenfilters.
Transforms,PrintInterfaceRemoteTransforms,andPrintInterfaceLPDCompatibilityFilterinput-trayOS/390V2R8Updated:Thisattributenowacceptsanynamesdefinedbytheadministratorinaprinterdefinition.
PrintInterfacelpCommandEnhancementsInterfaceChanges128z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||Table23.
SummaryofChangestoJobAttributes(continued)JobAttributeReleaseDescriptionRelatedSupportinput-tray-numberOS/390V2R8New:ThisattributeletstheuserspecifythenumberofaninputtraytoPSFandtotheAFPtoPCL,AFPtoPDF,andAFPtoPostScripttransforms.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsoutput-binOS/390V2R8Updated:Thisattributenowacceptsanynamesdefinedbytheadministratorinaprinterdefinition.
PrintInterfacelpCommandEnhancementsoutput-bin-numberOS/390V2R8New:ThisattributeletstheuserspecifythenumberofanoutputbintoPSFandtotheAFPtoPCL,AFPtoPDF,andAFPtoPostScripttransforms.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsresource-libraryOS/390V2R8Updated:Thisattributenowrequiresthatasetofdatasetsbeenclosedinbracesinsteadofsingleordoublequotationmarks.
PrintInterfacelpCommandEnhancementsshift-out-shift-inOS/390V2R8Updated:Thisattributenowalsoacceptsvaluethree.
PrintInterfacelpCommandEnhancementssysout-dataset-namez/OSV1R21New:ThisattributeletsyouspecifyanameforthedatasetthatPrintInterfaceallocatesontheJESspool.
sysout-job-idz/OSV1R21New:ThisattributeletsyouspecifyajobIDforthedatasetthatPrintInterfaceallocatesontheJESspool.
sysout-job-namez/OSV1R21New:ThisattributeletsyouspecifyajobnameforthedatasetthatPrintInterfaceallocatesontheJESspool.
AFPjobattributes2OS/390V2R8Updated:AusercannowspecifyAFPjobattributesontheafp2pcl,afp2pcl,andafp2pclcommands.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsAlljobattributesOS/390V2R8Updated:Alljobattributesarenowallowedforalltypesofprinterdefinitions(IPPrintWay,PSFforOS/390,andGeneral).
Iftheprinterdoesn'tsupportthejobattribute,itisignored.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransforms1.
ThesechangeshavebeenrolledbacktoOS/390V2R8andlaterreleases.
2.
AFPattributesare:carriage-control-type,chars,document-format,duplex,form-definition,input-tray,output-bin,overlay-back,overlay-front,page-definition,resource-library,shift-out-shift-in,table-reference-characters,x-image-shift-back,x-image-shift-front,y-image-shift-back,y-image-shift-frontMessagesRefertoOS/390SummaryofMessageChangesforalistofthenew,changed,anddeletedInfoprintServermessagesforOS/390V2R8.
Refertothe"SummaryofChanges"sectioninz/OSInfoprintServerMessagesandDiagnosisforalistofnew,changedanddeletedInfoprintServermessagesforz/OSV1R2.
ThispublicationalsodescribesthemessageformatofallInfoprintServermessages.
InterfaceChangesChapter5.
SummaryofInterfaceChanges129|||||||||||||||||||||||PIDUPrinterAttributesTable23onpage128listschangestotheprinterattributesthattheadministratorcanspecifywhentheadministratorusesthePrinterInventoryDefinitionUtility(PIDU).
PIDUletsyoucreateandeditPrinterInventoryobjects,suchasprinterdefinitionsandFSAdefinitions.
Refertoz/OSInfoprintServerOperationandAdministrationfordetailedinformationabouttheseprinterattributes.
Table24.
SummaryofChangestoPIDUPrinterAttributesPrinterAttributeReleaseDescriptionRelatedSupportconnection-timeoutz/OSV1R21New:ThisattributeletsyouspecifythenumberofsecondstowaitforTCP/IPtoestablishaconnectionwiththeprinter.
IPPrintWayTCP/IPConnectionTimeoutEnhancementcopiesz/OSV1R2Updated:Youcannowspecifyupto32640copies.
PrintInterface>255CopiesSupportdelete-form-feedz/OSV1R21New:ThisattributenowapplieswhentheIPPrintWayVTAMprotocolisselected.
IPPrintWayEnhancementsforPrintingtoVTAMPrintersemail-to-addressz/OSV1R21New:Thisattributeletsyouspecifyalistofe-mailaddresseswhentheIPPrintWaye-mailprotocolisselected.
IPPrintWayE-mailSupportline-terminationz/OSV1R21Updated:ThisattributenowapplieswhentheIPPrintWayVTAMprotocolisselected.
IPPrintWayEnhancementsforPrintingtoVTAMPrintersmaximum-copiesz/OSV1R2Updated:IPPrintWaynowusesthisattributetolimitthenumberofcopies.
IPPrintWayCopySupportforLANPrintersUpdated:Youcanspecifyavalueupto32640.
PrintInterface>255CopiesSupportnetspool-formattingz/OSV1R2Updated:Thisattributeletsyouselectanewvalue,convert-to-pcl.
Also,thestandardvalueisnowcalledconvert-to-line.
NetSpoolPCLConversionoptimize-copiesz/OSV1R2New:ThisattributeletsyoucontrolhowIPPrintWaytransmitsfileswhenprintingmultiplecopiesofadataset.
IPPrintWayCopySupportforLANPrinterspcl-line-densityz/OSV1R2New:ThisattributeletsyouspecifythenumberoflinesperinchwhenNetSpoolconvertsdatatoPCLformat.
NetSpoolPCLConversionpcl-orientationz/OSV1R2New:ThisattributeletsyouspecifyportraitorlandscapeorientationwhenNetSpoolconvertsdatatoPCLformat.
NetSpoolPCLConversionpcl-print-densityz/OSV1R2New:ThisattributeletsyouspecifythenumberofcharactersperinchwhenNetSpoolconvertsdatatoPCLformat.
NetSpoolPCLConversionprintway-formattingz/OSV1R21Updated:ThenonevaluenowapplieswhentheIPPrintWayVTAMprotocolisselected.
IPPrintWayEnhancementsforPrintingtoVTAMPrintersprotocolz/OSV1R21Updated:ThisattributeletsyouspecifythevalueemailtoselecttheIPPrintWaye-mailprotocol.
IPPrintWayE-mailSupportretained-fontsz/OSV1R21New:ThisattributeletsyouspecifythenumberoffontsthatPSFforOS/390istoretaininprinterstoragebetweenprintjobs.
PSFforOS/390FSADefinitionEnhancementsInterfaceChanges130z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||Table24.
SummaryofChangestoPIDUPrinterAttributes(continued)PrinterAttributeReleaseDescriptionRelatedSupportretained-form-definitionsz/OSV1R21New:ThisattributeletsyouspecifythenumberofformdefinitionsthatPSFforOS/390istoretaininvirtualstoragebetweenprintjobs.
PSFforOS/390FSADefinitionEnhancementsretained-object-containersz/OSV1R21New:ThisattributeletsyouspecifythenumberofobjectcontainersthatPSFforOS/390istoretaininprinterstoragebetweenprintjobs.
PSFforOS/390FSADefinitionEnhancementsretained-page-definitionsz/OSV1R21New:ThisattributeletsyouspecifythenumberofpagedefinitionsthatPSFforOS/390istoretaininvirtualstoragebetweenprintjobs.
PSFforOS/390FSADefinitionEnhancementsretained-page-segmentsz/OSV1R21New:ThisattributeletsyouspecifythenumberofpagesegmentsthatPSFforOS/390istoretaininprinterstoragebetweenprintjobs.
PSFforOS/390FSADefinitionEnhancementssave-printer-informationz/OSV1R21New:ThisattributeletsyourequestthatPSFforOS/390saveprinterinformationwhenitstartstheprinter.
PSFforOS/390FSADefinitionEnhancementsscs-automatic-page-orientationz/OSV1R2New:ThisattributeletsyourequestthatNetSpoolautomaticallydeterminetheappropriatepageorientation,portraitorlandscapeforeachpage.
NetSpoolPCLConversionvtam-send-as-transparentz/OSV1R21New:ThisattributeletsyourequestthatIPPrintWaysenddatatoaVTAM-controlledprinterastransparentdata.
IPPrintWayEnhancementsforPrintingtoVTAMPrinters1.
ThesechangeshavebeenrolledbacktoOS/390V2R8andlaterreleases.
NetSpoolOperatorCommandsTable25identifieschangestotheNetSpooloperatorcommandsforOS/390V2R8.
Refertoz/OSInfoprintServerOperationandAdministrationfordetailedinformationaboutthesecommands.
Table25.
SummaryofChangestoNetSpoolOperatorCommandsCommandNameReleaseDescriptionRelatedSupportNetSpoolWTOROS/390V2R8Deleted:TheoperatorcannolongerenterNetSpoolcommandsbyreplyingtotheNetSpoolWTORmessage:API0837IENTERNetSpooloperatorcommand.
TheoperatormustusetheMVSMODIFYcommandtoenterNetSpoolcommands.
NetSpoolOperatorCommandEnhancementsInterfaceChangesChapter5.
SummaryofInterfaceChanges131||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||Table25.
SummaryofChangestoNetSpoolOperatorCommands(continued)CommandNameReleaseDescriptionRelatedSupportDISPLAYOS/390V2R8Updated:Thiscommandcontainschangestokeywordsandstates:vDeleted:ALLandNOTSELkeywords;instead,theoperatorcanuseISPFpanelstolistallprintersconfiguredforusewithNetSpool.
vNew:LUNAMEandTRACEkeywords.
TheLUNAMEkeywordletstheoperatorseethestatusofoneNetSpoolprinterlogicalunit(LU);theTRACEkeywordletstheoperatorseewhichlogicalunitsarebeingtraced.
vNew:PENDINGCLOSEstate.
IfNetSpoolisintheprocessofstoppingaprinterLU,thenewstatusofPENDINGCLOSEisdisplayed.
NetSpoolOperatorCommandEnhancementsLUNAMEPURGEOS/390V2R8New:ThiscommanddeactivatestheprinterLUinVTAMimmediatelyandthenstopsNetSpoolprocessingforthatprinterLU.
Itisusefulforerrorsituations.
NetSpoolOperatorCommandEnhancementsREFRESHOS/390V2R8Deleted:ThiscommandisnolongersupportedbecauseNetSpoolautomaticallypicksupchangestoprinterdefinitionsinthePrinterInventory.
PrinterInventoryRELOADOS/390V2R8Deleted:ThiscommandisnolongersupportedbecauseNetSpoolautomaticallypicksupchangestoprinterdefinitionsinthePrinterInventory.
PrinterInventoryLUNAMEADDOS/390V2R8Updated:TheoperatornolongerneedstousethiscommandtostartaNetSpoolprinterLUthatisnewlydefinedtoNetSpoolbecauseNetSpoolcanautomaticallystarttheprinter.
Thiscommandneedstobeusedonlytostartaprinternotinastartedclass.
PrinterInventorySMFType6RecordTable26identifieschangestotheSMFtype6recordthatIPPrintWaywrites.
Refertoz/OSInfoprintServerOperationandAdministrationfordetailedinformationaboutthisrecord.
Table26.
SummaryofChangestoSMFType6RecordFieldNameReleaseDescriptionRelatedSupportSMF6JBNz/OSV1R21Updated:InthetwoSMFrecordsthatIPPrintWaywritesforasysoutdatasetwhentheresubmitforfilteringfunctionisused,thisfieldcontainsthejobnameoftheoriginalsysoutdataset.
IPPrintWayResubmitforFilteringEnhancementsInterfaceChanges132z/OSV1R2.
0InfoprintServerMigration|||||||||||||||||||Table26.
SummaryofChangestoSMFType6Record(continued)FieldNameReleaseDescriptionRelatedSupportSMF6USIDz/OSV1R21Updated:InthetwoSMFrecordsthatIPPrintWaywritesforasysoutdatasetwhentheresubmitforfilteringfunctionisused,thisfieldcontainstheuserIDofthejobsubmitteroftheoriginalsysoutdataset.
IPPrintWayResubmitforFilteringEnhancements1.
ThischangehasbeenrolledbacktoOS/390V2R8andlaterreleases.
StartupandShutdownProceduresTable27identifieschangestotheNetSpoolstartupprocedure;Table28onpage134identifieschangestotheIPPrintWaystartupprocedure;andTable29onpage134identifieschangestotheproceduresthatstartandstopInfoprintServerdaemons.
Refertoz/OSInfoprintServerCustomizationfordetailedinformationaboutthesestartupandshutdownprocedures.
Table27.
SummaryofChangestoNetSpoolStartupProcedureJCLStatementNameReleaseDescriptionRelatedSupportEXECOS/390V2R8vNew:TheINVparameterisrequiredtoidentifythePrinterInventoryManager.
vDeleted:TheWTORparameterisnolongerallowedbecauseNetSpoolnolongerissuesaWTORforenteringoperatorcommands.
vDeleted:ThePCDSparameterisnolongerallowedbecauseNetSpoolnolongersupportstheprint-characteristicsdatasetandtheIPPrintWayroutingandoptionsdatasets.
PrinterInventoryandNetSpoolOperatorCommandEnhancementsDDOS/390V2R8Deleted:TheAPIPRTCH,ANFROUTG,andANFOPTNSDDstatementsareignoredbecauseNetSpoolnowusesthePrinterInventoryinsteadoftheprint-characteristicsdatasetortheIPPrintWayroutingandoptionsdatasets.
PrinterInventoryOUTPUTOS/390V2R8Deleted:OUTPUTstatementsareignoredbecausetheadministratorcannowspecifyalloutputparametersintheprinterdefinition.
InsteadofconcatenatingOUTPUTstatementstobroadcastdatatomultipleprinters,theadministratornowcreatesaprinterpooldefinitioninthePrinterInventory.
NetSpoolDynamicAllocationEnhancementSTEPLIBz/OSV1R2Updated:TheSTEPLIBstatementisrequiredtospecifytheLEandC++run-timelibrariesiftheselibrariesarenotinthesystemLNKLST.
NetSpoolPCLConversionInterfaceChangesChapter5.
SummaryofInterfaceChanges133|||||||||||||||||||||||Table28.
SummaryofChangestotheIPPrintWayStartupProcedureJCLStatementNameReleaseDescriptionRelatedSupportEXECOS/390V2R8vNew:TheINVparameterisrequiredtoidentifythePrinterInventoryManager.
vDeleted:ThePARMparameterignoresparametersforhiperspaceblocks,TCP/IPname,tracing,andlanguageformessages.
Instead,thesevaluesmustbespecifiedinanFSSdefinitioninthePrinterInventory.
PrinterInventoryandIPPrintWayStartupEnhancementsDDOS/390V2R8vNew:TheSTDENVDDstatementisrequiredifyouusetheIPPrintWayIPPclientandInfoprintServerfilesarenotinstalledindefaultdirectories.
vDeleted:TheANFROUTGandANFOPTNSDDstatementsareignoredbecausethePrinterInventoryreplacestheroutingandoptionsdatasets.
vDeleted:TheSANFLOAD,SCEERUN,andSEZALINKdatasetsarenolongerrequiredintheSTEPLIBDDstatement;however,ifyouhavenotaddedtheCEE.
SCEERUNdatasettothesystemLNKLIST,thenyoumustaddittotheSTEPLIBDDstatement.
vDeleted:TheANFLIBandANFCALLDDstatementsareignoredifspecifiedbecausetheIPPclientinIPPrintWaynolongerrequiresJava.
(PTFUW74452removedtherequirementforJava.
)PrinterInventoryandIPPrintWayVTAMPrinterSupportCNTL,PRINTDEV,ENDCNTLOS/390V2R8Deleted:Thesestatementsareignored.
Instead,theadministratorcanspecifytracingparametersinanFSAdefinitioninthePrinterInventory.
IPPrintWayStartupEnhancementsTable29.
SummaryofChangestoInfoprintServerStartupandShutdownProceduresProcedureNameReleaseDescriptionRelatedSupportAOPSTARTOS/390V2R8New:ThisprocedurestartsInfoprintServerdaemons.
PrinterInventoryz/OSV1R2Updated:YoucannowspecifysomeenvironmentvariablesintheSTDENVDDstatement.
AOPSTARTandAOPSTOPProcedureEnhancementsAOPSTOPOS/390V2R8New:ThisprocedurestopsInfoprintServerdaemons.
PrinterInventoryz/OSV1R2Updated:The–doptionletsyoustopselecteddaemons.
AOPSTARTandAOPSTOPProcedureEnhancementsz/OSV1R2Updated:The-dsubdoptionletsyoustopthePrintInterfacesubsystemdaemon.
PrintInterfaceSubsystemforBatchApplicationsSYS1.
MACLIBMembersTable31onpage135identifieschangestomacrosinSYS1.
MACLIB.
Refertoz/OSInfoprintServerCustomizationforinformationaboutthemembersinthistable.
InterfaceChanges134z/OSV1R2.
0InfoprintServerMigration||||||||||||||||Table31.
SummaryofChangestoSYS1.
MACLIBMacroNameReleaseDescriptionRelatedSupportANFUEXTPOS/390andz/OSV1R2Updated:ThisIPPrintWaymacrocontainsfieldsthatareinputtoIPPrintWayexits.
Exitscanalsoupdatefieldsinthismacro.
See"Exits"onpage113forinformationaboutthenewandupdatedfieldsforOS/390andz/OSV1R2.
ANFGPWFLOS/390V2R8Deleted:ThisIPPrintWaymacroisobsolete.
ItwaspreviouslyusedtocreateentriesintheIPPrintWayroutingandoptionsdatasetsPrinterInventoryAPIPPDPFOS/390V2R8Deleted:ThisNetSpoolmacroisobsolete.
Itwaspreviouslyusedtocreateapage-formattable.
PrinterInventoryAPIPPEFMOS/390V2R8Deleted:ThisNetSpoolmacroisobsolete.
Itwaspreviouslyusedtocreateanend-of-filerulestable.
PrinterInventoryAPIPPP1X2z/OSV1R2Updated:ThenewS2FLAGSfieldidentifiestheLUtypeoftheVTAMsessionandthetypeofoutputdatastream(lineorPCLdatastream).
NetSpoolExitEnhancementsSYS1.
PROCLIBMembersTable32identifieschangestotheJCLproceduresprovidedbyInfoprintServerinSYS1.
PROCLIB.
Refertoz/OSInfoprintServerCustomizationfordetailedinformationabouttheseprocedures.
Table32.
SummaryofChangestoSYS1.
PROCLIBProcedureNameReleaseDescriptionRelatedSupportANFWPROCOS/390V2R8Updated:ThissampleIPPrintWaystartupprocedureshowsthenewformatofthestartupprocedure.
PrinterInventoryAOPPRINTOS/390V2R8New:ThisprocedureletsuserssubmitabatchjobtoprintUNIXandMVSdatasetsandusefunctionsprovidedbyPrintInterface.
PrintInterfaceAOPPRINTJCLProcedureAOPSTARTOS/390V2R8New:ThisprocedurestartsInfoprintServerdaemons.
PrinterInventoryz/OSV1R2Updated:YoucannowspecifysomeenvironmentvariablesintheSTDENVDDstatement.
AOPSTARTandAOPSTOPProcedureEnhancementsAOPSTOPOS/390V2R8New:ThisprocedurestopsInfoprintServerdaemons.
PrinterInventoryz/OSV1R2Updated:Youcannowspecifyoptionstostopselecteddaemons.
AOPSTARTandAOPSTOPProcedureEnhancementsAPIJPJCLOS/390V2R8Updated:ThissampleNetSpoolstartupprocedureshowsthenewformatofthestartupprocedure.
PrinterInventory,"NetSpoolDynamicAllocationEnhancement"onpage87SYS1.
SAMPLIBMembersTable33onpage136identifiesthemembersinSYS1.
SAMPLIBthatarenewandchanged.
Refertoz/OSInfoprintServerCustomizationforinformationaboutthemembersinthistable.
InterfaceChangesChapter5.
SummaryofInterfaceChanges135|||||||||||||||||||||||||||InOS/390V2R8,sampleIPPrintWayjobsweremovedfromANF.
SANFSAMPtoSYS1.
SAMPLIB,andsampleNetSpooljobsweremovedfromAPI.
SAPISAMPtoSYS1.
SAMPLIB.
Thesesamplejobsarenotlistedinthistableunlesstheywereupdatedinalaterrelease.
Table33.
SummaryofChangestoSYS1.
SAMPLIBMemberNameReleaseDescriptionRelatedSupportANFQINITOS/390V2R8New:SampleJCLtocreateandinitializetheIPPrintWaytransmission-queuedataset.
PrinterInventoryANFUXRT2OS/390V2R8New:SampleIPPrintWayRoutingexitthatchangesanIPaddresstoaURL.
IPPrintWayIPPClientANFUXRT3OS/390V2R8New:SampleIPPrintWayRoutingexitthatchangestheIPaddressandchangesaprintqueuenametoaportnumber.
None.
ANFUXRT4OS/390V2R8New:SampleIPPrintWayRoutingexitthatchangesaprinterdefinitionnametoCLASS,DEST,andFORMSvalues.
PrinterInventoryANFUXBD3OS/390V2R8New:SampleIPPrintWayBeginDataSetexitthatprintsabannerpagebeforethefirstdatasetinajob.
None.
AOPCPETCz/OSV1R2New:ThisfilecopiesalloftheInfoprintServersampleconfigurationfilestoadirectorywhereyoucaneditthem.
SampleCustomizationFilesAOPJAUTHOS/390V2R8New:ThisprocedureAPF-authorizesJavalibrariesrequiredbythePrintInterfaceIPPserver.
PrintInterfaceIPPServerAOPMIGRTOS/390V2R8New:SampleJCLforrunningthemigrationprogramtomigrateNetSpool,IPPrintWay,andPrintInterfaceprinterinformation;thisprocedureusestheAOPBATCHutility.
PrinterInventoryAOPMIGRXOS/390V2R8New:SampleJCLforrunningthemigrationprogramtomigratePSFcustomizationinformation;thisprocedureusestheAOPBATCHutility.
PrinterInventoryAOPPIDUOS/390V2R8New:SampleJCLforrunningthePrinterInventoryDefinitionUtility(PIDU)programusingtheAOPBATCHutility.
PrinterInventoryAOPRACFz/OSV1R2New:ThisfilecontainsalltheRACFcommandsrequiredtocustomizethesecurityfunctioninInfoprintServer.
SampleCustomizationFilesAOXCF30JOS/390V2R8New:SampleJCLforrunningAOXCF30,afont-scalingprogramprovidedbyInfoprintServerTransformswiththeAFPtoPCL,AFPtoPDF,andAFPtoPostScripttransforms.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsAOXFONTSOS/390V2R8New:Samplefont-mappingtableprovidedbyInfoprintServerTransformswiththeAFPtoPCL,AFPtoPDF,andAFPtoPostScripttransformfeatures.
Thistableisthesameastheinternalfont-mappingtableusedbyeachtransform.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsAOX2PCLJOS/390V2R8New:Usermodtoreplacefont-mappingtableintheAFPtoPCLtransform.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsInterfaceChanges136z/OSV1R2.
0InfoprintServerMigration||||||||||||||||Table33.
SummaryofChangestoSYS1.
SAMPLIB(continued)MemberNameReleaseDescriptionRelatedSupportAOX2PDFJOS/390V2R8New:Usermodtoreplacefont-mappingtableintheAFPtoPDFtransform.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsAOX2PSJOS/390V2R8New:Usermodtoreplacefont-mappingtableintheAFPtoPostScripttransform.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsAPIJPTD1z/OSV1R2Updated:ThissampleBeginningofFileexitforSCSdatanowdeterminesthetypeofoutputdatastream(lineorPCLdatastream)andperformsdifferentfunctionsforeachtype.
NetSpoolExitEnhancementsAPIJPTD2z/OSV1R2Updated:ThissampleTransparentDataexitforSCSdatanowdeterminesthetypeofoutputdatastream(lineorPCLdatastream)andperformsdifferentfunctionsforeachtype.
NetSpoolExitEnhancementsAPIJUBF3z/OSV1R2New:SampleBeginningofFileexitfor3270datastreams.
NetSpoolExitEnhancementsAPIJUGEXz/OSV1R2New:SampleNetSpoolGraphicEscapeexit.
NetSpoolExitEnhancementsTSOLogonProcedureTable34identifieschangestotheTSOlogonprocedureforInfoprintServerinOS/390V2R8.
Refertoz/OSInfoprintServerCustomizationfordetailedinformationaboutthelogonprocedure.
Table34.
SummaryofChangestoTSOLogonProcedureDDStatementNameReleaseDescriptionRelatedSupportISPMLIBOS/390V2R8vUpdated:TouseInfoprintServerISPFpanels,concatenateoneofthefollowinglibraries:AOP.
SAOPMENU(English),AOP.
SAOPMJPN(Japanese),orAOP.
SAOPMESP(Spanish).
Previously,theselibrarieswererequiredonlytousePrintInterfaceISPFpanels,butnottouseIPPrintWaypanels.
vDeleted:LibrariesANF.
SANFPLIB,ANF.
SANFPJPN,andANF.
SANFPESPareobsolete.
PrinterInventoryz/OSV1R2vDeleted:TheAOP.
SAOPMESP(Spanish)libraryhasbeenremoved.
InfoprintServerISPFmessagesarenolongeravailableinSpanish.
InterfaceChangesChapter5.
SummaryofInterfaceChanges137|||||||||||||||||||||||||||||||||Table34.
SummaryofChangestoTSOLogonProcedure(continued)DDStatementNameReleaseDescriptionRelatedSupportISPPLIBOS/390V2R8vUpdated:Oneofthefollowinglibrariesmustbeconcatenated:AOP.
SAOPPENU(English),AOP.
SAOPPJPN(Japanese),AOP.
SAOPPESP(Spanish).
Previously,theselibrarieswererequiredonlytousePrintInterfaceISPFpanels,butnottouseIPPrintWaypanels.
vDeleted:LibrariesANF.
SANFPLIB,ANF.
SANFPJPN,andANF.
SANFPESPareobsolete.
PrinterInventoryz/OSV1R2vDeleted:TheAOP.
SAOPPESP(Spanish)libraryhasbeenremoved.
InfoprintServerISPFpanelsarenolongeravailableinSpanish.
ISPMALTOS/390V2R8Deleted:LibraryANF.
SANFMJPNisobsolete.
PrinterInventoryISPPALTOS/390V2R8Deleted:LibraryANF.
SANFPJPNisobsolete.
PrinterInventorySYSEXECOS/390V2R8vDeleted:LibraryANF.
SANFEXECisobsolete.
vUpdated:LibraryAOP.
SAOPEXECmustbeconcatenated.
PrinterInventory/usr/lpp/Printsrv/samples/DirectoryTable35identifiesthenewandchangedfilesinthe/usr/lpp/Printsrv/samples/directory.
Refertoz/OSInfoprintServerCustomizationfordetailedinformationaboutthesefiles.
Table35.
SummaryofChangesto/usr/lpp/Printsrv/samples/DirectoryFileNameReleaseDescriptionRelatedSupportaopapi.
hOS/390V2R8New:Headerfileforapplicationprogramminginterface(API)functionsPrintInterfaceAPIaopd.
confOS/390V2R8Updated:AsampleInfoprintServerconfigurationfile,updatedtoshowthenewstatements.
PrinterInventory,PrintInterfaceIPPServer,SNMPSubagent,Transformsaoprform.
confz/OSV1R21New:AconfigurationfilerequiredbythePrintInterfaceremotetransformfunction.
Youdonotneedtoeditthisfile.
PrintInterfaceRemoteTransformSupportforIBMInfoprintColor130PlusPrinteraopsapd.
confOS/390V2R8New:AsampleSAPCallbackdaemonconfigurationfile.
Transforms,PrintInterfaceSAPOutputManagementSystemaopxfd.
confOS/390V2R8New:Asampletransformconfigurationfile.
Transforms,AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsinfoprint.
omsOS/390V2R8New:AsamplefilethatdefinesoneSAPROMSandtwoSAPLOMSs.
Transforms,PrintInterfaceSAPOutputManagementSystemInterfaceChanges138z/OSV1R2.
0InfoprintServerMigration|||||||||||||||Table35.
SummaryofChangesto/usr/lpp/Printsrv/samples/Directory(continued)FileNameReleaseDescriptionRelatedSupportsample.
pidlOS/390V2R8New:SampleinputtothePrinterInventoryDefinitionUtility(PIDU).
PrinterInventory1.
ThischangehasbeenrolledbacktoOS/390V2R8andlaterreleases.
z/OSUNIXCommandsTable36liststhechangestothez/OSUNIXcommandsforOS/390V2R8.
Refertothefollowingchaptersandpublicationsforadditionalinformation:vChapter6,"InfoprintServerMigrationProgram"onpage141fordetailedinformationabouttheaopmigcommandvz/OSInfoprintServerOperationandAdministrationfordetailedinformationabouttheaopstart,aopstop,andpiducommandsvz/OSInfoprintServerUser'sGuidefordetailedinformationabouttheafp2pcl,afp2pdf,afp2ps,lp,lpstat,pcl2afp,pdf2afp,ps2afp,andsap2afpcommandsTable36.
SummaryofChangestoz/OSUNIXCommandsCommandNameReleaseDescriptionRelatedSupportafp2pclOS/390V2R8New:TransformsAdvancedFunctionPresentation(AFP)andlinedataintoPrinterControlLanguage(PCL)format;providedbyInfoprintServerTransforms.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsafp2pdfOS/390V2R8New:TransformsAdvancedFunctionPresentation(AFP)andlinedataintoPortableDataFormat(PDF);providedbyInfoprintServerTransforms.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsafp2psOS/390V2R8New:TransformsAdvancedFunctionPresentation(AFP)andlinedataintoPostScriptformat;providedbyInfoprintServerTransforms.
AFPtoPCL,AFPtoPDF,andAFPtoPostScriptTransformsaopmigOS/390V2R8New:ThiscommandmigratesexistingprinterinformationusedbypreviousreleasesofIPPrintWay,NetSpool,andPrintInterface.
PrinterInventoryaopstartOS/390V2R8Updated:ThiscommandstartsInfoprintServerdaemonsconfiguredintheInfoprintServerconfigurationfile.
Ifyouusethedefaultconfigurationfile,thesamedaemonsstartasinpreviousreleases.
PrinterInventory,PrintInterfaceIPPServer,Transforms,SNMPSubagentz/OSV1R2Updated:ThiscommandnowisaneditableREXXEXECthatcontainsalloftheenvironmentvariablesusedbyInfoprintServerdaemons,exceptfortheAOPTRACEONandLANGvariables.
ItnowmustbeownedbyUID0.
SecureEnvironmentaopstopOS/390V2R8Updated:Thenew-doptionletstheoperatorstopselecteddaemons.
PrintInterfaceIPPServer,Transforms,SNMPSubagentz/OSV1R2Updated:The-dsubdoptionletstheoperatorstopthePrintInterfacesubsystemdaemon.
lpOS/390V2R8Thiscommandcanacceptsomenewattributes.
See"JobAttributes"onpage128fornewandchangedjobattributes.
PrintInterfacelpCommandEnhancementsInterfaceChangesChapter5.
SummaryofInterfaceChanges139|||||||||||||Table36.
SummaryofChangestoz/OSUNIXCommands(continued)CommandNameReleaseDescriptionRelatedSupportlpstatOS/390V2R8vNew:Thepurgedandfailedstatesarenew.
vUpdated:IfIPPrintWaysuccessfullytransmittedthefiletoaLANprinter,lpstatnowreportsthestateascompletedinsteadofprocessing.
vUpdated:IfIPPrintWayfailedtotransmitafiletoaLANprinter,lpstatnowreportsthestateasfailedinsteadofprocessing.
PrintInterfaceJobStatusEnhancementspcl2afpOS/390V2R8New:TransformsPrinterControlLanguage(PCL)filesintoAdvancedFunctionPresentation(AFP)formatforprintingonIBMAFPprinters;providedbyInfoprintServerTransforms.
Transformspdf2afpandps2afpOS/390V2R8New:TransformPostScriptorPortableDocumentFormat(PDF)filesintoAdvancedFunctionPresentation(AFP)formatforprintingonIBMAFPprinters;providedbyInfoprintServerTransforms.
TransformspiduOS/390V2R8New:CreatesentitiesinthePrinterInventory.
TheInfoprintServerISPFpanelsprovideanalternativemethodofcreatingentries.
PrinterInventorysap2afpOS/390V2R8New:TransformsanSAPOutputTextFormat(OTF)orSAPAdvancedBusinessApplicationProgramming(ABAP)datastreamfileintoanAdvancedFunctionPresentation(AFP)datastreamfileforprintingonIBMAFPprinters;providedbyInfoprintServerTransforms.
TransformsInterfaceChanges140z/OSV1R2.
0InfoprintServerMigrationChapter6.
InfoprintServerMigrationProgramTheInfoprintServerPrinterInventoryprovidedinOS/390V2R8andlaterreleasesletstheadministratorspecifyprinterinformationrequiredbyallInfoprintServercomponents(PrintInterface,NetSpool,IPPrintWay,Transforms,theSNMPsubagent)inthesamerepository.
ThismeansthattheadministratorcandefineoneprinterdefinitionthatcanbeusedbyallInfoprintServercomponents.
See"PrinterInventory"onpage53formoreinformationaboutthePrinterInventory,printerdefinitions,andtheothertypesofentriestheadministratorcancreate.
InfoprintServerprovidesamigrationprogram,aopmig,tohelptheadministratormigrateexistingIPPrintWay,NetSpool,andPrintInterfaceprinterinformationtonewprinterdefinitions,printerpooldefinitions,andcomponentsinthePrinterInventoryintroducedinOS/390V2R8.
Note:IfyoualreadyrunInfoprintServeronOS/390V2R8orlater,donotrunthemigrationprogramwhenyoumigratetoalaterrelease.
Migratingexistingprinterinformationisatwo-stepprocess:1.
Runthemigrationprogram.
Themigrationprogramreadsexistingprinterinformation,identifiesrelationshipsbetweenprinters,andgeneratesprinterinventorydefinitionstatements.
Themigrationprogramalsogeneratesareportofitsprocessing,whichyoucanexamineforpossibleerrorconditions.
YoucanrerunthemigrationprogramasoftenasyouwantbeforeyourunthePIDUprogramtocreatethePrinterInventory,becausethemigrationprogramonlygeneratestextoutputfilesanddoesnotmodifyyourinputfilesorcreateanyentriesinthePrinterInventory.
Inmostcases,youshouldnotneedtorerunthemigrationprogram;howeveryoumightneedtorerunitifyoufailedtospecifythecorrectinputparametersthefirsttime.
Eachtimeyourerunthemigrationprogram,theoutputfilescontainingtheprinterinventorydefinitionstatementsandtheprocessingreportarereplaced.
2.
RunthePrinterInventoryDefinitionUtility(PIDU)program.
ThePIDUprogramusestheprinterinventorydefinitionstatementsgeneratedbythemigrationprogramasinputandcreatesprinterdefinitions,components,andprinterpooldefinitionsinthePrinterInventory.
Ifyouwant,youcancreateentriesinthePrinterInventorybeforerunningthePIDUprogramtomigrateyourexistingprinterinformation;however,ifyoudo,thePIDUprogrammightnotbeabletocreatesomeentriesduetoduplicateentrynamesinthePrinterInventory.
Notes:1.
ThemigrationprogramdoesnotmigrateconfigurationinformationinIPPrintWaystartupprocedurestoFSSandFSAdefinitionsinthePrinterInventory.
IfyoucurrentlyspecifythePARMparameterontheEXECstatementofanIPPrintWaystartupprocedure,youmustcreateanFSSdefinitionandpossiblyanFSAdefinitioninthePrinterInventory.
2.
ThemigrationprogramcanmigrateinformationinPSFforOS/390startupprocedurestoFSSandFSAdefinitionsinthePrinterInventory.
RefertoPSFforOS/390&z/OS:CustomizationforinformationabouthowtomigratePSFinformation.
Table37onpage142liststhetasksthatarerelatedtorunningthemigrationprogram.
Requiredtasksapplytoallinstallations.
Optionaltasksapplyincertainsituations.
Fordetailsontheproceduresassociatedwithatask,seethereferenceCopyrightIBMCorp.
19992002141||listed.
Table37.
SummaryofMigrationTasksForInformationAbout:ConditionSeePage:Runthemigrationprogram.
Required142Inspectthereportfromthemigrationprogramtofindpossibleerrors.
Optional152RunthePrinterInventoryDefinitionUtility(PIDU)Required153IfyoufinderrorsinthePIDUprogramorPrinterInventory,rerunthemigrationprogramandthePIDUprogram.
Optional154Editprinterdefinitions,components,orprinterpooldefinitionsinthePrinterInventoryifnecessary.
Optional155RunningtheMigrationProgramThefollowingdatasetsareinputparameterstothemigrationprogram:vPrintInterfaceprinterinventoryfilesvNetSpoolprint-characteristicsdatasetsvNetSpoolend-of-filerulesdatasetsvNetSpoolpage-formatdatasetsvNetSpoolstartupproceduresthatcontainOUTPUTstatementsvIPPrintWayroutingdatasetsvIPPrintWayoptionsdatasetsImportantNoteWhenyourunthemigrationprogram,specifyalloftheinputdatasetsthatyourinstallationusesatthesametime;thatis,onthesameaopmigcommand.
Forexample,ifyourunNetSpoolandIPPrintWay,specifyalloftheNetSpoolandalloftheIPPrintWaydatasets.
ThisisbecausethemigrationprogramcombinesNetSpool,IPPrintWay,andPrintInterfaceprinterinformationthatreferstothesameprinterintoonenewprinterdefinition.
Themigrationprogramcancombineprinterinformationonlyifyouspecifyallinputdatasetsthatyourinstallationusesandmigrateeverythingatonetime.
IfyourinstallationrunsIPPrintWayandNetSpoolonmorethanonesystem,runthemigrationprogramseparatelyforeachsystem.
YoucanalsorunthemigrationprogramtomigratePSFforOS/390startupproceduresseparatelybecausethePSFinformationisnotmergedwithprinterinformationfromPrintInterface,NetSpool,orIPPrintWay.
Youcanrunthemigrationprogramintwoways:vFromthez/OSUNIXSystemServicesshellusingtheaopmigcommandvFromTSOusingtheAOPBATCHutilityprogramPreparingtoRuntheMigrationProgramBeforerunningthemigrationprogram,youmustcustomizethePrinterInventoryManagerbecausethemigrationprogramusesenvironmentvariablesand142z/OSV1R2.
0InfoprintServerMigrationstatementsintheaopd.
confconfigurationfile.
Refertoz/OSInfoprintServerCustomizationforinformationabouthowtocustomizethePrinterInventoryManager.
Whenyourunthemigrationprogram,NetSpool,IPPrintWay,andInfoprintServerdaemonscanberunningonyourz/OSsystem;however,thisisnotnecessary.
NetSpoolandIPPrintWaycanberunningonotherMVS,OS/390,orz/OSsystemsandsharingtheNetSpoolandIPPrintWaydatasetsthatareinputtothemigrationprogram.
Table13onpage112summarizestheinformationthatyoumustcollectbeforerunningthemigrationprogram.
Thistablealsonamestheoptionontheaopmigcommandinwhichyouspecifythisinformation;seethedescriptionsoftheseoptionsin"Options"onpage144formoreinformationandforexamplesofthevaluesyouneedtospecify.
IfyourinstallationdoesnotcurrentlyrunNetSpool,IPPrintWay,orPrintInterface,youdonotneedtocollecttheinformationrelatedtothatproduct.
Table38.
SummaryofInformationRequiredbytheMigrationProgramRequiredInformationaopmigOptionNameofthedirectorythatcontainsthePrintInterfaceprinterinventoryfiles.
-nNameofthepartitioneddatasetthatcontainstheNetSpoolpage-formattable,APIPPPFT1-dNameofthepartitioneddatasetthatcontainstheNetSpoolend-of-filerulestable,APIPPEFT1-eNameofthedatasetthatcontainstheNetSpoolstartupprocedure(requiredifthestartupprocedurecontainsOUTPUTstatements)1-jNameoftheNetSpoolprint-characteristicsdataset1-pNameoftheIPPrintWayroutingdataset1-rNameoftheIPPrintWayoptionsdataset1-oDefaultclassnamethatJESassignstoSYSOUTdatasets2-cDefaultformsnamethatJESassignstoSYSOUTdatasets2-fDefaultdestnamethatJESassignstoSYSOUTdatasets2-t1.
IfyourinstallationrunsmultipleinstancesofNetSpoolorIPPrintWayonthesamesystemorusesmultipleinputdatasetsofthesametype,youmustspecifythenamesofalldatasets.
See"MigratingMultipleNetSpoolandIPPrintWayDataSets"onpage147forinformation.
2.
Thedefaultclass,dest,andformsvaluesarenotrequiredifyoucurrentlyrunonlyIPPrintWay.
Also,ifyourinstallationdefinesmorethanonedefaultclass,dest,orformsvaluetoJES,youmustspecifyalldefaultvalues.
See"SpecifyingMultipleJESDefaultValues"onpage148forinformation.
Chapter6.
InfoprintServerMigrationProgram143RunningtheMigrationProgramUsingtheaopmigCommandFormataopmig[-hs][-cdefault_class].
.
.
[-d'NetSpool_page_format_dataset'].
.
.
[-e'NetSpool_EOF_rules_dataset'].
.
.
[-fdefault_forms].
.
.
[-i'JES_initialization_dataset'].
.
.
[-j'NetSpool_OUTPUT_JCL_dataset'].
.
.
[-nPrint_Interface_printers][-o'IP_PrintWay_options_dataset'].
.
.
[-p'NetSpool_PCDS'].
.
.
[-r'IP_PrintWay_routing_dataset'].
.
.
[-tdefault_dest].
.
.
[-x'PSF_procedure_dataset'].
.
.
Descriptionaopmigreadsexistingprinterinformation,identifiesrelationshipsbetweenprinters,andgeneratesprinterinventorydefinitionstatementsthatthePrinterInventoryDefinitionUtility(PIDU)programcanusetocreateprinterdefinitionsandcomponentsinthePrinterInventory.
Note:Themigrationprogramwritestheinventorydefinitionstatementsitgeneratestoitsstdoutfile.
Itwritesareportofitsprocessingtoitsstderrfile.
Bydefault,bothstdoutandstderraredirectedtotheterminal.
Therefore,inmostcases,youshouldredirectstdoutandstderrtoUNIXfilesusingtheUNIXredirectionsymbols(>forstdoutand2>forstderr).
Seetheexamplesin"Examples"onpage149forexamplesthatshowhowtousetheseredirectionsymbols.
Options-cdefault_classThedefaultoutputclassthatJESassignstosysoutdatasets.
SpecifythedefaultoutputclassthatJESassignstosysoutdatasetsonthesystemwhereNetSpoolorPrintInterfacecurrentlyrun;inJES2systems,thedefaultclassistypicallyA.
InmatchingNetSpoolandPrintInterfaceprinterdefinitionswithIPPrintWayroutingentries,themigrationprogramtreatsprinterdefinitionsthatlackaclassvalueasthoughtheycontainthisdefaultvalue.
Thisoptionisnotrequired;however,IBMstronglyrecommendsthatyouspecifythisoptionifyouruneitherNetSpoolorPrintInterfaceandsomeoftheNetSpoolandPrintInterfaceprinterdefinitionsdonotcontainaclassvalue.
Youcanspecifythisoptionandvaluemorethanonce;see"SpecifyingMultipleJESDefaultValues"onpage148formoreinformation.
Example:-cA-d'NetSpool_page_format_dataset'ThenameofthepartitioneddatasetthatcontainstheNetSpoolpage-formattable.
Enclosethedatasetnameinsinglequotationmarksifthenamecontainscharacters(suchas#or$)thatmightbeinterpretedbytheshell.
Ifyourinstallationhasnotcreateditsownpage-formattable,specifythedatasetthatcontainstheNetSpoolloadmodules.
Ifyourinstallationhascreateditsownpage-formattable,thetablemustbeassembledandlinkedited.
Thisoptionisnotrequired;howeverIBMrecommendsthatyouspecifythisoptionifyourunNetSpool.
Youcanspecifythisoptionandvaluemorethanonce;see"MigratingMultipleNetSpoolandIPPrintWayDataSets"onpage147formoreinformation.
Note:Donotspecifythemembername.
Themigrationprogram,likeNetSpool,alwaysusesthemembernamedAPIPPPFT.
144z/OSV1R2.
0InfoprintServerMigrationExample:-d'API.
SAPIMOD1'-e'NetSpool_EOF_rules_dataset'ThenameofthepartitioneddatasetthatcontainstheNetSpoolend-of-filerulestable.
Enclosethedatasetnameinsinglequotationmarksifthenamecontainscharacters(suchas#or$)thatmightbeinterpretedbytheshell.
Ifyourinstallationhasnotcreateditsownend-of-filerulestable,specifythedatasetthatcontainstheNetSpoolloadmodules.
Ifyourinstallationhascreateditsownend-of-filerulestable,thetablemustbeassembledandlinkedited.
Thisoptionisnotrequired;howeverIBMrecommendsthatyouspecifythisoptionifyourunNetSpool.
Youcanspecifythisoptionandvaluemorethanonce;see"MigratingMultipleNetSpoolandIPPrintWayDataSets"onpage147formoreinformation.
Note:Donotspecifythemembername.
Themigrationprogram,likeNetSpool,alwaysusesthemembernamedAPIPPEFT.
Example:-e'API.
SAPIMOD1'-fdefault_formsThedefaultformsnamethatJESassignstosysoutdatasets.
YourinstallationdefinesthisvaluetoJESduringinitialization.
SpecifythedefaultformsnamethatJESassignstosysoutdatasetsonthesystemwhereNetSpoolandPrintInterfacecurrentlyrun.
InmatchingNetSpoolandPrintInterfaceprinterdefinitionswithIPPrintWayroutingentries,themigrationprogramtreatsprinterdefinitionsthatlackaformsvalueasthoughtheycontainthisdefaultvalue.
Thisoptionisnotrequired;however,IBMstronglyrecommendsthatyouspecifythisoptionifyouruneitherNetSpoolorPrintInterfaceandsomeoftheNetSpoolandPrintInterfaceprinterdefinitionsdonotcontainaformsvalue.
Youcanspecifythisoptionandvaluemorethanonce;see"SpecifyingMultipleJESDefaultValues"onpage148formoreinformation.
Example:-fSTD-hRequeststhataopmigdisplaytheformatoftheaopmigcommand.
Specifythisoptionbyitself,withoutspecifyinganyotheroptions.
-j'NetSpool_OUTPUT_JCL_dataset'ThenameofthedatasetthatcontainsNetSpoolOUTPUTstatements.
Enclosethedatasetnameinsinglequotationmarksifthenamecontainscharacters(suchasor$)thatmightbeinterpretedbytheshell.
Thisoptionisnotrequired;however,IBMrecommendsthatyouspecifythisoptionifyourunNetSpoolandyourNetSpoolstartupprocedurecontainsOUTPUTJCLstatements.
Youcanspecifythisoptionandvaluemorethanonce;see"MigratingMultipleNetSpoolandIPPrintWayDataSets"onpage147formoreinformation.
Example:-j'SYS1.
PROCLIB(APIJPJCL)'-i'JES_initialization_dataset'ThenameofthedatasetthatcontainsJESinitializationstatementsforPSFforOS/390.
RefertoPSFforOS/390&z/OS:Customizationforinformationaboutthisoption.
-nPrint_Interface_printersThenameofthedirectoryinwhichPrintInterfaceprinterdefinitionsareChapter6.
InfoprintServerMigrationProgram145stored.
IfyouinstalledPrintInterfaceinthedefaultdirectory,specify/var/Printsrv/printers.
Thevalueyouspecifyforthisoptioniscasesensitive.
Thisoptionisnotrequired;however,IBMrecommendsthatyouspecifythisoptionifyourrunPrintInterface.
Example:-n/var/Printsrv/printers-o'IP_PrintWay_options_dataset'ThenameoftheIPPrintWayoptionsdataset.
Enclosethedatasetnameinsinglequotationmarksifthenamecontainscharacters(suchas#or$)thatmightbeinterpretedbytheshell.
Thisoptionisnotrequired;however,IBMrecommendsthatyouspecifythisoptionifyourunIPPrintWayanduseanIPPrintWayoptionsdataset.
Youcanspecifythisoptionandvaluemorethanonce;see"MigratingMultipleNetSpoolandIPPrintWayDataSets"onpage147formoreinformation.
Example:-o'ANF.
OPTIONS'-p'NetSpool_PCDS'ThenameoftheNetSpoolprint-characteristicsdataset.
Enclosethedatasetnameinsinglequotationmarksifthenamecontainscharacters(suchasor$)thatmightbeinterpretedbytheshell.
Thisoptionisnotrequired;however,IBMrecommendsthatyouspecifythisoptionifyourunNetSpoolanduseaNetSpoolprint-characteristicsdataset.
Youcanspecifythisoptionandvaluemorethanonce;see"MigratingMultipleNetSpoolandIPPrintWayDataSets"onpage147formoreinformation.
Example:-p'API.
PCDS'-r'IP_PrintWay_routing_dataset'ThenameoftheIPPrintWayroutingdataset.
Enclosethedatasetnameinsinglequotationmarksifthenamecontainscharacters(suchas#or$)thatmightbeinterpretedbytheshell.
Thisoptionisnotrequired;however,IBMrecommendsthatyouspecifythisoptionifyourunIPPrintWayanduseanIPPrintWayroutingdataset.
Youcanspecifythisoptionandvaluemorethanonce;see"MigratingMultipleNetSpoolandIPPrintWayDataSets"onpage147formoreinformation.
Example:-r'ANF.
ROUTING'-sSuppressesthemergingofIPPrintWayJCLroutingcriteria.
Ifyouselectthisoption,IPPrintWaycreatesaprinterdefinitionforeachIPPrintWayroutingentryintheIPPrintWayroutingdataset.
ThisoptionappliesonlyifyourunIPPrintWay.
Bydefault,themigrationprogrammergesIPPrintWayJCLroutingcriteria(DEST,CLASS,andFORMSparameters)wheneverpossibletocreateoneprinterdefinition.
EachIPPrintWayroutingentrycontainsaDEST,FORMS,andCLASSvalue;however,startingwithOS/390V2R8,IPPrintWayletstheadministratoromitoneortwooftheseroutingcriteriaiftheprinterdefinitionappliestosysoutdatasetswithanyvaluefortheomittedparameters.
See"IPPrintWayExtendedRoutingCriteria"onpage94formoreinformationaboutthisenhancement.
Tosupportthisenhancement,themigrationprogramidentifiesroutingentriesthatcanbecombinedintoasingleprinterdefinitionbyomittingoneormoreoftheDEST,FORMS,andCLASSparameters.
Themigration146z/OSV1R2.
0InfoprintServerMigrationprogramcombinesroutingentriesonlyifalltheentrieshavethesamecontents.
Seethe"MergeIPPrintWayRoutingCriteria"sectionin"UsingtheMigrationProgramReport"onpage152foranexampleofhowthemigrationprogrammergesroutingentries.
-tdefault_destThedefaultdestnamethatJESassignstosysoutdatasets.
YourinstallationdefinesthisvaluetoJESduringinitialization.
SpecifythedestnamethatJESassignstosysoutdatasetsonthesystemwhereNetSpoolorPrintInterfacecurrentlyrun.
InmatchingNetSpoolandPrintInterfaceprinterdefinitionswithIPPrintWayroutingentries,themigrationprogramtreatsprinterdefinitionsthatlackadestvalueasthoughtheycontainthisdefaultvalue.
Thisoptionisnotrequired;however,IBMstronglyrecommendsthatyouspecifythisoptionifyouruneitherNetSpoolorPrintInterfaceandsomeoftheNetSpoolandPrintInterfaceprinterdefinitionsdonotcontainadestvalue.
Youcanspecifythisoptionandvaluemorethanonce;see"SpecifyingMultipleJESDefaultValues"onpage148formoreinformation.
Example:-tLOCAL-x'PSF_procedure_dataset'ThenameofthedatasetthatcontainsthePSFstartupprocedure.
RefertoPSFforOS/390&z/OS:Customizationforinformationaboutthisoption.
-Requeststhataopmigdisplaytheformatoftheaopmigcommand.
Thisoptionisequivalenttothe-hoption.
Specifythisoptionbyitself,withoutspecifyinganyotheroptions.
MigratingMultipleNetSpoolandIPPrintWayDataSetsIfyourinstallationrunsmultipleinstancesofNetSpoolorIPPrintWayonthesamesystemandusesmultipleNetSpoolorIPPrintWayinputdatasetsofthesametype,youmustspecifyallinputdatasetstothemigrationprogramwiththesameaopmigcommand.
YoumustspecifytheNetSpoolinputdatasetsthatbelongtogetherasaset;andyoumustspecifytheIPPrintWayinputdatasetsthatbelongtogetherasaset.
ThefollowingexamplesshowhowtomigratemultipleNetSpoolandIPPrintWaydatasets:vMigratingmultipleNetSpooldatasets:IfyourunthreeinstancesofNetSpool,andeachinstanceusesitsownprint-characteristicsdataset,itsownOUTPUTJCLstatements,anditsownend-of-filerulestable,repeatthe-p,-j,and-eoptionsandvaluesasaset.
Inthisexample,allinstancesofNetSpoolsharethesamepage-formattable;therefore,thatinputdatasetisspecifiedonlyonetime.
Youcouldinsteadrepeatthe-doptionandvaluethreetimes.
Thisexamplealsospecifiesthedefaultclass,dest,andformsvalues.
Ifyourinstallationdefinesmorethanonedefaultclass,dest,orformstoJES,repeatthedefaultvaluesasaset,asshown.
aopmig-pAPI.
PCDS1-j'SYS1.
PROCLIB(NET1)'-eUSER.
LIB1\-pAPI.
PCDS2-j'SYS1.
PROCLIB(NET2)'-eUSER.
LIB2\-pAPI.
PCDS3-j'SYS1.
PROCLIB(NET3)'-eUSER.
LIB3\-dAPI.
SAPIMOD1\-cA-tLOCAL-fSTD1-cA-tLOCAL-fSTD2\>aopmig.
invdefs2>aopmig.
reportvMigratingMultipleIPPrintWayDataSets:IfyouruntwoinstancesofIPPrintWay,andeachinstanceusesitsownroutingdatasetandoptionsdataset,repeatthe-rand-ooptionsasaset.
aopmig-rANF.
ROUTING1-oANF.
OPTIONS1\-rANF.
ROUTING2-oANF.
OPTIONS2\>aopmig.
invdefs2>aopmig.
reportChapter6.
InfoprintServerMigrationProgram147vMigratingMultipleNetSpoolandIPPrintWayDataSets:IfyouruntwoinstancesofNetSpoolandIPPrintWay,andeachinstanceusesitsownIPPrintWayroutingdataset,IPPrintWayoptionsdataset,NetSpoolOUTPUTJCLstatements,andNetSpoolend-of-filerulestable,repeatthe-r,-o,-j,and-eoptionsandvaluesasaset.
Inthisexample,bothinstancesofNetSpoolsharethesamepage-formattable;therefore,thisinputdatasetisspecifiedonlyonetime.
Youcouldrepeatthe-doptionandvaluetwotimes.
aopmig-rANF.
ROUTING1-oANF.
OPTIONS1-j'SYS1.
PROCLIB(NET1)'-eUSER.
LIB1\-rANF.
ROUTING2-oANF.
OPTIONS2-j'SYS1.
PROCLIB(NET2)'-eUSER.
LIB2\-dAPI.
SAPIMOD1\>aopmig.
invdefs2>aopmig.
reportWhenyoumigratemultipledatasetsofthesametype,itispossibleforthemigrationprogramtoencountermultipleentitieswiththesamename.
Themigrationprogramhandlesidenticallynamedentitiesasfollows:vItignoresduplicateentities,thatis,entitiesthathavethesamename(orthesameroutingkey)andidenticalcontents.
vForNetSpoolprinterdefinitionsandIPPrintWayroutingentriesthathavedifferentcontents,itacceptsthefirstinstanceoftheentityandignorestherest.
vForNetSpoolend-of-fileandpage-formatentriesandforNetSpoolOUTPUTJCLstatements,themigrationprogramassignsanewnametoeachuniqueversionoftheentityandupdatesallreferencestothoseentities.
vForIPPrintWayoptionsentries,themigrationprogramretainsthefirstinstanceofeachentrytosatisfyreferencestoitusingthePRTOPTNSJCLparameter.
Foreachuniqueversionofanoptionsentrywiththesamename,themigrationprogramassignsanewnameandupdatesallreferencestotheoptionsentry.
SpecifyingMultipleJESDefaultValuesIfyouaremigratingfromNetSpoolorPrintInterfaceandyourinstallationdefinesmorethanonedefaultclass,dest,orformsvaluetoJES,youmustspecifyallofthedefaultvaluestothemigrationprogram.
Todothis,repeatthe-c,-t,and-foptionsandvaluesasaset,asshowninthefollowingexample:aopmig-pAPI.
PCDS1-j'SYS1.
PROCLIB(NET1)'-eUSER.
LIB1-dAPI.
SAPIMOD1\-cA-tLOCAL-fSTD1\-cA-tLOCAL-fSTD2\>aopmig.
invdefs2>aopmig.
reportUsageNotesvIfyouruntheaopmigcommandfromtheOMVSshellanddonothaveroomtotypealloftherequiredcommandoptionsonthecommandline,dooneofthefollowing:–Userlogintologintothez/OSUNIXSystemServicesshellfromaplatform,suchasUNIX,thatsupportstherloginfunction.
Eithertypetheentireaopmigcommandonthesamecommandline,ortypethebackslashcharactertocontinuetheaopmigcommandonthenextlineasshownin"Examples"onpage149.
Donottypeanyblankspacesorothercharactersafterthebackslash.
–Createandexecuteashellscriptthatcontainstheaopmigcommandandoptions.
Forinformationabouthowtocreateashellscript,refertoz/OSUNIXSystemServicesUser'sGuide.
Thebasicstepsforcreatingashellscriptare:1.
UsetheOEDITcommandoranothermethodtocreateaUNIXfile.
Inthisfile,specifytheaopmigcommandandoptions.
Tocontinueoptionsonthenextline,typethebackslashcharacter;donottypeanyblankspacesorothercharactersafterthebackslash.
Theaopmigcommandandoptions148z/OSV1R2.
0InfoprintServerMigrationarecasesensitive,sobesuretotypethecorrectuppercaseandlowercasecharacters.
Entertheaopmigcommandandoptionsasshownin"Examples".
2.
Usethechmodcommandtosetreadandexecutepermissionsforthefile.
Onlytheownerofthefilecansetpermissions.
Forexample,iftheshellscriptnameisaopmig.
command,enterontheOMVScommandline::chmoda+rxaopmig.
command3.
ExecutetheshellscriptfromtheOMVScommandline.
Forexample,iftheshellscriptnameisaopmig.
command,enterontheOMVScommandline:aopmig.
commandvThemigrationprogramusestheASCIIandEBCDICcodepagesspecifiedintheInfoprintServerconfigurationfile(aopd.
conf)whenitmigratesNetSpoolorIPPrintWayprinterinformation.
Ifthestandarddefaultcodepagesarenotsuitableforyourinstallation,specifythedesiredcodepagesinthisfile.
Refertoz/OSInfoprintServerCustomizationfordetailedinformationabouttheconfigurationfile.
vYoucanrerunthemigrationprogramasoftenasyouwantbeforeyourunthePIDUprogramtocreatethePrinterInventory,becausethemigrationprogramonlygeneratestextoutputfilesanddoesnotmodifyinputfilesorcreateanyentriesinthePrinterInventory.
Eachtimeyourunthemigrationprogram,itreplacestheinventorydefinitionstatementsandthereportofitsprocessing.
vThemigrationprogramwritestheinventorydefinitionstatementsitgeneratestoitsstdoutfile.
Itwritesitsreporttoitsstderrfile.
Becausebothstdoutandstderraredirectedtotheterminalbydefault,inmostcases,youshouldredirectstdoutandstderroutputtofileusingtheUNIXredirectionsymbols(>forstdoutand2>forstderr.
See"Examples"forexamplesofhowtodothis.
vSavethestdoutfilefromthemigrationprogramuntilyouaresatisfiedwiththeentriesinthePrinterInventory.
Youmightneedtoeditthefileifyouneedtorerunthemigrationprogram.
See"RerunningtheMigrationProgramandthePIDUProgram"onpage154formoreinformation.
ExamplesThissectionshowshowtoentertheaopmigcommandtomigratePrintInterface,NetSpool,andIPPrintWaydatasets.
Youcanenterthesecommandsfromthez/OSUNIXSystemServicesshellortypethemintoashellscript.
Thebackslashcharacterindicatesthattheaopmigcommandcontinuesonthenextline;donottypeanyspacesorothercharactersafterthebackslash.
Ifyouloggedintoz/OSUNIXSystemServicesusingtheOMVScommand,youcannotcontinuetheaopmigcommandonanotherline.
Inthiscase,eitheruserlogintologintoz/OSUNIXSystemServicesorcreateashellscriptasdescribedin"UsageNotes"onpage148.
Foradditionalexamples,see"MigratingMultipleNetSpoolandIPPrintWayDataSets"onpage147and"SpecifyingMultipleJESDefaultValues"onpage148.
MigratingfromPrintInterface:EnterthefollowingcommandtomigratethePrintInterfaceprinterinventoryfilesinthe/var/Printsrv/printersdirectory:aopmig-n/var/Printsrv/printers>aopmig.
invdefs2>aopmig.
reportMigratingfromNetSpool:Enterthefollowingcommandtomigratethesedatasetsandtables:Chapter6.
InfoprintServerMigrationProgram149vNetSpoolprint-characteristicsdatasetAPI.
PCDSvNetSpoolpage-formattableinAPI.
SAPIMOD1vNetSpoolend-of-filerulestableinUSER.
LIBvOutputstatementsinNetSpoolstartupprocedureNETSPOOLinSYS1.
PROCLIBThe-c,-f,and-toptionsspecifythedefaultclass,forms,anddestvaluesfortheinstallation.
aopmig-pAPI.
PCDS-dAPI.
SAPIMOD1-eUSER.
LIB-j'SYS1.
PROCLIB(NETSPOOL)'\-cA-tLOCAL-fSTD1>aopmig.
invdefs2>aopmig.
reportMigratingfromIPPrintWay:Enterthefollowingcommandtomigratethesedatasets:vIPPrintWayroutingdatasetANF.
ROUTINGvIPPrintWayoptionsdatasetANF.
OPTIONSaopmig-rANF.
ROUTING-oANF.
OPTIONS>aopmig.
invdefs2>aopmig.
reportMigratingfromPrintInterface,NetSpool,andIPPrintWay:Enterthefollowingcommandtomigratethesedatasetsandtables:vPrintInterfaceprinterinventoryinthe/var/Printsrv/printersdirectoryvNetSpoolprint-characteristicsdatasetAPI.
PCDS;ifyourinstallationhasdefinedNetSpoolprintersintheIPPrintWayroutingandoptionsdataset,omitthe-poptionthatspecifiesthisdataset.
vIPPrintWayroutingdatasetANF.
ROUTINGvIPPrintWayoptionsdatasetANF.
OPTIONSvNetSpoolpage-formattableinAPI.
SAPIMOD1vNetSpoolend-of-filerulestableinUSER.
LIBvOutputJCLstatementsinNetSpoolstartupprocedureAPIJPJCLinSYS1.
PROCLIBThe-c,-f,and-toptionsspecifythedefaultclass,forms,anddestvaluesfortheinstallation.
aopmig-n/var/Printsrv/printers-pAPI.
PCDS-rANF.
ROUTING-oANF.
OPTIONS\-dAPI.
SAPIMOD1-eUSER.
LIB-j'SYS1.
PROCLIB(APIJPJCL)'\-cA-fSTD1-tLOCAL>aopmig.
invdefs2>aopmig.
reportEnvironmentVariablesAOPCONFNamestheInfoprintServerconfigurationfile.
Thisenvironmentvariableisoptional;ifspecified,thefilenamedinthisvariabletakesprecedenceovertheuser-specificconfigurationfile,$HOME/.
aopconf,andthesystemdefaultconfigurationfile,/etc/Printsrv/aopd.
conf.
Files$HOME/.
aopconfContainstheuser-specificInfoprintServerconfigurationfile.
Thisfiletakesprecedenceover/etc/Printsrv/aopd.
conf.
/etc/Printsrv/aopd.
confThedefaultInfoprintServerconfigurationfile.
Thisfileisoptional.
RunningtheMigrationProgramfromTSOYoucanrunthemigrationprogramfromTSOusingtheAOPBATCHutility,whichIBMrecommends,ortheBPXBATCHutility.
IfyouusetheAOPBATCHutility,specifythePATHenvironmentvariable;specifytheLIBPATHandNLSPATH150z/OSV1R2.
0InfoprintServerMigrationenvironmentvariablesonlyifyourinstallationdidnotinstallInfoprintServerfilesinthedefaultdirectories.
IfyouusetheBPXBATCHutility,specifythePATH,LIBPATH,andNLSPATHenvironmentvariables.
WhenyouuseeithertheAOPBATCHortheBPXBATCHutility,alsospecifytheAOPCONFenvironmentvariableifyouwanttoexplicitlyspecifythelocationoftheInfoprintServerconfigurationfile.
Refertoz/OSInfoprintServerCustomizationforinformationabouthowtosettheseenvironmentvariables.
WhenyouuseeithertheAOPBATCHorBPXBATCHutility,youcanspecifycommandlineargumentsusingthePARMparameterontheEXECstatement.
However,becausethevalueforthePARMparametercannotexceed100characters,inmostcasesyoushouldusetheenvironmentvariablesshowninTable39tospecifyinputparameterstothemigrationprogram.
Table39.
EnvironmentVariablesforRunningtheMigrationProgramfromTSOEnvironmentVariableComparableCommandLineOptionAOPMIG_DEFAULT_CLASS-cAOPMIG_NETSPOOL_PAGE_FORMAT-dAOPMIG_NETSPOOL_EOF_RULES-eAOPMIG_DEFAULT_FORMS-fAOPMIG_NETSPOOL_OUTPUT_JCL-jAOPMIG_PRINT_INTERFACE_PRINTERS-nAOPMIG_IP_PRINTWAY_OPTIONS-oAOPMIG_NETSPOOL_PCDS-pAOPMIG_IP_PRINTWAY_ROUTING-rAOPMIG_SUPPRESS_CRITERIA_MERGE-sAOPMIG_DEFAULT_DEST-tNotes:1.
Theseenvironmentvariablescanhaveonlyonevalue.
Ifyouneedtospecifymultipleinputdatasetsforamigrationprogramoption,runthemigrationprogramfromthez/OSUNIXSystemServicesshell.
2.
ThevaluefortheAOPMIG_PRINT_INTERFACE_PRINTERSenvironmentvariableiscasesensitive;thevaluesfortheotherenvironmentvariablesarenot.
IBMprovidessampleJCLintheAOPMIGRTmemberofSYS1.
SAMPLIBforrunningthemigrationprogramusingtheAOPBATCHutility.
Figure1onpage152showsmemberAOPMIGRT.
Chapter6.
InfoprintServerMigrationProgram151UsingtheMigrationProgramReportThemigrationprogramwritesareportofitsprocessingtostderr.
Youdonotneedtoreadthisreport;however,youmightwanttoscanittodetectpossibleerrorconditions.
Followingaresomehintsforreadingorscanningtheerrorreport:vTryreadingorscanningthereportonlinebecauseitcanbequitelarge.
vTofinderrorsfoundbythemigrationprogram,searchfortheword"Error"inthereport.
vTofindwarningsfoundbythemigrationprogram,searchfortheword"Warning"inthereport.
vSearchforthesesectionsinthereport:–"PrintInterfacePrintersThatDidNotMatchIPPrintWay"–"UnreferencedComponents"–"MissingComponents"Ifanyofthesesectionscontaindata,itmightindicatethatyoudidnotspecifyalloftheNetSpoolandPrintInterfacedatasetsusedbyyourinstallationtothemigrationprogram.
Ifthisisthecase,rerunthemigrationprogramandspecifyallinputdatasets.
//AOPMIGRTJOBMSGLEVEL=(1,1)//**//*THISJCLWILLUSETHEAOPBATCHUTILITYTORUNTHEaopmig*//*PROGRAMTOMIGRATEOS/390PRINTSERVER,IPPRINTWAY,*//*NETSPOOLDEFINITIONSTOINFOPRINTSERVER.
*//**//*REPLACEhlqANDvolumeWITHVALUESAPPROPRIATEFORYOUR*//*SYSTEM.
DONOTMODIFYPARM='aopmig'.
ALSOSETTHEVARIABLES*//*INSTDENVTOINDICATETHEDATASETNAMESONYOURSYSTEM.
*//**//*//MIGRTEXECPGM=AOPBATCH,PARM='aopmig'//*//STDOUTDDDSN=hlq.
INVDEFS,//DISP=(NEW,CATLG,DELETE),//DCB=(RECFM=VB,LRECL=4096),//UNIT=SYSALLDA,VOL=SER=volume,SPACE=(TRK,(5,15,0))//*//STDERRDDSYSOUT=*//*//STDENVDD*PATH=/usr/lpp/Printsrv/bin:/bin:AOPMIG_PRINT_INTERFACE_PRINTERS=/var/Printsrv/printersAOPMIG_IP_PRINTWAY_ROUTING=ANF.
ROUTINGAOPMIG_IP_PRINTWAY_OPTIONS=ANF.
OPTIONSAOPMIG_NETSPOOL_OUTPUT_JCL=API.
OUTPUTSAOPMIG_NETSPOOL_PCDS=API.
PCDSAOPMIG_NETSPOOL_EOF_RULES=API.
LOADLIBAOPMIG_NETSPOOL_PAGE_FORMAT=API.
LOADLIB/*Figure1.
SampleJCLforRunningtheMigrationProgramfromTSO—AOPMIGRTinSYS1.
SAMPLIB152z/OSV1R2.
0InfoprintServerMigrationvSearchforsectionsentitled"DefinitionsThatHaveIdenticalKeys".
Ifthesesectionsexistandcontaindata,themigrationprogramcouldnotmigratethelistedentriesintheinputdatasets.
vSearchforsection"AssignNamestoNamelessInfoprintServerPrinters"inthereport.
Thissectionlistsprinterdefinitionnamesthatthemigrationprogramgenerated.
Thesenamesbeginwiththeprefix"is_gen".
Ifthesenamesarenotsuitable,youcanchangethemafteryourunthePIDUprogramtocreatethePrinterInventory.
SeeAppendixA,"MigrationReport"onpage159foradescriptionofeachsectioninthemigrationreport.
RunningthePrinterInventoryDefinitionUtility(PIDU)Afterrunningthemigrationprogramandreviewingthereportofitsprocessing,runthePrinterInventoryDefinitionUtility(PIDU)programtocreateentries(printerdefinitions,components,andprinterpooldefinitions)intheInfoprintServerPrinterInventory.
UsethedefinitionstatementsthatthemigrationprogramgeneratesandwritestostdoutasinputtothePIDUprogram.
Note:BeforerunningthePIDUprogram,ensurethatthePrinterInventoryManagerdaemon,aopd,isrunning;refertoz/OSInfoprintServerOperationandAdministrationforinformationabouthowtostartthePrinterInventoryManagerdaemon.
NetSpool,IPPrintWay,andanyotherInfoprintServerdaemonscanalsoberunningwhenyourunthePIDUprogram;however,thisisnotnecessary.
WhenthePrinterInventoryManagerstarts,itcreatesthePrinterInventoryfilesiftheydonotalreadyexist.
ThePrinterInventoryfiles(master.
dbandjestoken.
db)arecreatedinthedirectoryyouspecifiedinthebase-directorystatementintheInfoprintServerconfigurationfile(/etc/Printsrv/aopd.
conf);thedefaultdirectoryis/var/Printsrv.
TovieworeditthePrinterInventoryfiles,usetheInfoprintServerISPFpanelsorthePIDUprogram.
Refertoz/OSInfoprintServerOperationandAdministrationforinformationabouthowtousetheISPFpanelsandthePIDUprogram.
YoucanrunthePIDUprogramintwoways:vFromthez/OSUNIXSystemServicesshellusingthepiducommandvFromTSOusingtheAOPBATCHutilityprogramRunningthePIDUProgramUsingthepiduCommandTorunthePIDUprogramyoucanenterthepiducommandfromthez/OSUNIXcommandline.
Namethefilethatcontainstheprinterinventorydefinitionstatementscreatedbythemigrationprogramasinputtothepiducommand.
ThePIDUprogramwritesareportoferrorstostderr.
Bydefault,stderrisdirectedtotheterminal.
YoushouldredirectthisoutputtoafileusingtheUNIXredirectionsymbol(2>forstderr).
Forexample,ifyouenteredthefollowingcommandfromthez/OSUNIXcommandlinetodirecttheprinterinventorydefinitionstatementstoafilenamedaopmig.
invdefs:aopmig.
.
.
>aopmig.
invdefs2>aopmig.
reportChapter6.
InfoprintServerMigrationProgram153Thenenterthefollowingpiducommandandspecifytheaopmig.
invdefsfileasinput:pidupidu.
reportRunningthePIDUProgramfromTSOYoucanalsorunthePIDUprogramfromTSOusingtheAOPBATCHutilityprogram,whichIBMrecommends,ortheBPXBATCHutilityprogram.
IntheSTDINDDstatement,youcaneitherspecifythePIDUcommandstatementsoryoucannameafilethatcontainsthePIDUcommandstatements.
IfyouusetheAOPBATCHutility,specifythePATHenvironmentvariable;specifytheLIBPATHandNLSPATHenvironmentvariablesonlyifyourinstallationdidnotinstallInfoprintServerfilesinthedefaultdirectories.
IfyouusetheBPXBATCHutility,specifythePATH,LIBPATH,andNLSPATHenvironmentvariables.
WhenyouuseeithertheAOPBATCHortheBPXBATCHutility,alsospecifytheAOPCONFenvironmentvariableifyouwanttoexplicitlyspecifythelocationoftheconfigurationfile.
Refertoz/OSInfoprintServerCustomizationforinformationabouthowtosettheseenvironmentvariables.
IBMprovidessampleJCLintheAOPPIDUmemberofSYS1.
SAMPLIBforrunningthePIDUprogramusingtheAOPBATCHutility.
Figure2showsmemberAOPPIDU.
RerunningtheMigrationProgramandthePIDUProgramYoucanrerunthemigrationprogramasoftenasyouwantbeforeyourunthePIDUprogramtocreatethePrinterInventory.
However,ifyouneedtorerunthemigration//AOPPIDUJOB,'pidu'//*//*SampleJCLforrunningpiduinbatch.
//*//*ThisJCLwillusetheAOPBATCHutilitytorunthepiduprogram//*toprocessInfoprintServerinventorydefinitions.
//*//*Replacehlqwiththeappropriatevalue.
Usetheaopmigrtor//*aopmigrxjobtocreatethehlq.
invdefsdataset.
Youmayedit//*thedefinitionsinthedatasetasneeded.
//*//*STDINmayalsopointtoasequentialdatasetcontainingother//*PrinterInventoryDefinitionLanguage(PIDL)statements.
//*//*//PIDUEXECPGM=AOPBATCH,PARM='pidu'//*//STDINDDDSN=hlq.
INVDEFS,DISP=SHR//*//STDOUTDDSYSOUT=*//STDERRDDSYSOUT=*//*//*STDENVmaypointtoadatasetcontainingenvironmentvariables.
//*Builtinvalueswillworkforthedefaultinstallation.
//*STDENVDDDSN=environment,DISP=SHRFigure2.
SampleJCLforRunningthePIDUProgramfromTSO—AOPPIDUinSYS1.
SAMPLIB154z/OSV1R2.
0InfoprintServerMigrationprogramafteryouhavealreadyrunthePIDUprogram,youmustfirstdeletetheentriesinthePrinterInventorythatwerecreatedwhenyoupreviouslyranthePIDUprogram.
Todothis,followthesesteps:1.
EditthefilethatcontainstheinputstatementstothePIDUprogram.
Changeall"create"statementsinthisfileto"delete"statements.
Forexample,changethissample"create"statement:createallocationDMJOK10copies=5;Tothis"delete"statement:deleteallocationDMJOK10;Also,besuretodeleteallprinterdefinitionsbeforeyoudeletethecomponentsthatareincludedintheprinterdefinitions.
Youcanusethefollowingawkprogramtocreateafilewith"delete"statementsinthecorrectorder.
Ifyourinputfileisnamedaopmig.
invdefs,enterthesecommandsonthez/OSUNIXcommandline:awk'/∧create/{printNR""$2""$3}'pidu.
report3.
Rerunthemigrationprogramaopmig.
4.
RerunthePIDUprogram.
ViewingandEditingthePrinterInventoryAfterrunningthePIDUprogram,youcanuseInfoprintServerISPFpanelstobrowsethenewprinterdefinitions,components,andprinterpooldefinitionsinthePrinterInventory.
YoucanalsousetheISPFpanelstoedittheseentriesifdesired.
Ifyouneedtomakethesamechangestomanyprinterdefinitions,youcanusethePIDUprogram.
Refertoz/OSInfoprintServerOperationandAdministrationforinformationabouthowtousetheISPFpanelsandhowtousethePIDUprogramtoeditthePrinterInventory.
Youmightwanttoeditprinterdefinitionsforthefollowingreasons:vChangenamesofprinterdefinitionsandcomponents:IfyoumigratedNetSpoolorIPPrintWaydatasets,themigrationprogrammighthavegeneratednamesforsomeofthenewprinterdefinitions.
YoumightwanttochangetheprinterdefinitionnamestosomethingmoremeaningfultojobsubmittersifyourinstallationplanstousethePrintInterfacecomponentofInfoprintServer.
Chapter6.
InfoprintServerMigrationProgram155Seereportsection"AssignNamestoNamelessInfoprintServerPrinters"in"UsingtheMigrationProgramReport"onpage152foradescriptionofhowthemigrationprogramassignsnames.
Forexample,ifthemigrationprogrammigratedanIPPrintWayroutingentrytoaprinterdefinition,thenthenameoftheprinterdefinitionistheconcatenationoftheDEST,CLASS,andFORMSvaluesintheroutingentry.
Insomecases,themigrationprogrammighthavegeneratednamesforprinterdefinitionsandcomponentsthatstartwith"is_gen",inordertoavoidduplicatenamesinthePrinterInventory.
Tochangethesenames,youcanusetheInfoprintServerISPFpanelstolistallprinterdefinitionsorcomponentswhosenamesbeginwith"is_gen"andeditthem.
vDeleteunusedcomponents:IfyoumigratedfromNetSpoolorIPPrintWay,themigrationprogrammighthavecreatedcomponentsthatarenotincludedinanyprinterdefinitions.
Ifyourmigrationprogramreportcontainssection"UnreferencedComponents",usetheISPFpanelstobrowsethecomponentslistedinthissectiontoseewhetheryourinstallationusesthem;ifyourinstallationdoesnotusethem,youcandeletethemfromthePrinterInventory.
vCreatemissingcomponents:IfyoumigratedfromNetSpoolorIPPrintWay,andtheinputdatasetsaremissingsomeentries,themigrationprogrammighthavecreatedprinterdefinitionsthatrefertomissingcomponents.
Ifyourmigrationprogramreportcontainssection"MissingComponents",youcanusetheISPFpanelstocreatethecomponentslistedinthissection.
vSpecifyIPaddressesforprinterdefinitions:IfyoumigratedfromPrintInterface,themigrationprogrammighthavecreatedprinterdefinitionsthatdonotspecifyanIPaddressforthetargetIPPrintWayprinter.
Ifyourmigrationprogramreportcontainssection"PrintInterfacePrintersThatDidNotMatchIPPrintWay",youcanusetheISPFpanelstoeitherdeleteoredittheprinterdefinitionslistedinthissection.
IfaprinterdefinitionlacksanIPaddress,theusermustspecifytheIPaddressonthelpcommand,AOPPRINTJCLprocedure,orOUTPUTJCLstatement;otherwise,IPPrintWaydetectsanerror.
vForceIPPrintWaytousestandardTCP/IPEBCDICtoASCIItranslatetable:IfyoumigratedfromIPPrintWay,andyourIPPrintWayoptionsentriesusethestandardTCP/IPtranslatetablestoconvertdatafromEBCDICtoASCII,youmightseeadifferenceinprintedoutput.
ThisisbecauseIPPrintWay,startingwithOS/390V2R8,bydefaultusestheiconvconversionutilitytoconvertdatafromEBCDICtoASCII.
Iftheoutputisnotsuitableforyourinstallation,youcanedittheprinterdefinitionsandProcessingcomponentscreatedbythemigrationprogramandtheIPPrintWayFSSdefinitiontoforceIPPrintWaytousethestandardTCP/IPtranslatetable.
ForinformationaboutthefieldsyouneedtospecifytouseastandardTCP/IPtranslationtable,refertoz/OSInfoprintServerOperationandAdministration.
vSpecifyprinterattributesforPrintInterface:IfyoumigratedfromNetSpoolorIPPrintWay,andnowyourinstallationplanstousethePrintInterfacecomponentofInfoprintServer,youcansimplyedittheprinterdefinitionscreatedbythemigrationprogramandspecifytheprinterattributesusedbyPrintInterface.
ForinformationabouttheprinterattributesusedbyPrintInterface,refertoz/OSInfoprintServerOperationandAdministration.
vSpecifyprinterattributesforNetSpool:IfyoumigratedfromPrintInterfaceorIPPrintWay,andnowyourinstallationplanstousetheNetSpoolcomponentofInfoprintServer,youcansimplyedittheprinterdefinitionscreatedbythemigrationprogramandspecifytheprinterattributesusedbyNetSpool.
ForinformationabouttheprinterattributesusedbyNetSpool,refertoz/OSInfoprintServerOperationandAdministration.
156z/OSV1R2.
0InfoprintServerMigrationvChangethetypeofGeneralprinterdefinitions:IfyoumigratedfromNetSpool,themigrationprogrammighthavecreatedprinterdefinitionswiththetype"General"forprintersthatarecontrolledbyPSFforOS/390.
TheprinterdefinitiontypeforaPSFprinteris"PSFforOS/390";however,themigrationprogramdidnothavesufficientinformationtodetectthattheseprinterswerePSFprinters.
YoumightwanttousetheInfoprintServerISPFpanelstolistallGeneralprinterdefinitionsandchangethetypeofthePSFprintersto"PSFforOS/390";however,thisisnotnecessarybecauseGeneralprinterdefinitionscontainthesamesetofprinterattributesasPSFforOS/390printerdefinitions.
Chapter6.
InfoprintServerMigrationProgram157158z/OSV1R2.
0InfoprintServerMigrationAppendixA.
MigrationReportThemigrationprogramwritesareportofitsprocessingtostderr.
Thisreportisdividedintosections.
Eachsectioncorrespondstoaprocessingstepthatthemigrationprogramperforms;thesectionsarewritteninchronologicalorder.
Themigrationprogramincludesmostreportsectionsevenifthemigrationprogramhadnodatatoprocess.
Inthiscase,thereportsectiondoesnotcontainanydata.
ThereportreferstoprinterattributesthatthemigrationprogramgeneratesforusebythePrinterInventoryDefinitionUtilityprogram,forexample:lpr-restrict-ports=yes.
Inmostcases,thenamesoftheseprinterattributesareself-explanatory.
Followingisalistofthesectionheadingsinthesameorderasinthemigrationreport.
Thesectionsarenumberedinthispublicationsothatyoucaneasilyfindthedescriptionofaparticularsectionintheparagraphsthatfollow;theseheadingnumbersarenotincludedinthereportitself.
Eachsectioninthereportbeginswithalineofasterisks(*);alineofdashes(-)separatesentrieswithinasection.
1.
OptionsandArgumentsUsedbythisProgram2.
ConvertIPPrintWayOptionsEntries(mayberepeated)3.
IdenticallyNamedDefinitionsThatDiffer(optional)4.
IPPrintWayOptionsEntriesinConvertedFormat5.
ConvertIPPrintWayRoutingEntries(mayberepeated)6.
DefinitionsThatHaveIdenticalKeys(optional)7.
IPPrintWayRoutingEntriesinConvertedFormat8.
ConvertPrintInterfacePrinters9.
PrintInterfacePrintersinConvertedFormat10.
ConvertNetSpoolOUTPUTStatements(mayberepeated)11.
IdenticallyNamedDefinitionsThatDiffer(optional)12.
NetSpoolOUTPUTStatementsinConvertedFormat13.
DefaultOUTPUTStatementNames14.
ConvertNetSpoolOptionsEntries(mayberepeated)15.
IdenticallyNamedDefinitionsThatDiffer(optional)16.
NetSpoolOptionsEntriesinConvertedFormat17.
OverridesinConvertedNetSpoolOptionsEntries18.
ConvertNetSpoolEnd-of-FileRulesEntries(mayberepeated)19.
IdenticallyNamedDefinitionsThatDiffer(optional)20.
NetSpoolEnd-of-FileRulesEntriesinConvertedFormat21.
ConvertNetSpoolPageFormatEntries(mayberepeated)22.
IdenticallyNamedDefinitionsThatDiffer(optional)23.
NetSpoolPageFormatEntriesinConvertedFormat24.
ConvertNetSpoolRoutingEntries(mayberepeated)25.
DefinitionsThatHaveIdenticalKeys(optional)26.
NetSpoolPrintersinConvertedFormatfromRoutingEntries27.
ConvertNetSpoolPCDSDefinitions(mayberepeated)28.
DefinitionsThatHaveIdenticalKeys(optional)29.
NetSpoolPrintersinConvertedFormatfromPCDS30.
ModifyIPPrintWayPageHeightValues31.
Addlpr-restrict-portstoMaintainCurrentBehavior32.
InfoprintServerComponentsfromIPPrintWayOptionsEntries33.
Addlpr-restrict-portstoMaintainCurrentBehavior34.
AdjustedIPPrintWayRoutingEntries35.
AdjustedPrintInterfacePrinters36.
InfoprintServerComponentsfromNetSpoolEnd-of-FileRulesEntries37.
InfoprintServerComponentsfromNetSpoolPageFormatEntriesCopyrightIBMCorp.
1999200215938.
NetSpoolPrintersAdjustedforPooling39.
NetSpoolPools40.
InfoprintServerComponentsfromNetSpoolOptionsEntries41.
NetSpoolPrintersAdjustedforPooling42.
NetSpoolPools43.
InfoprintServerComponentsfromNetSpoolOUTPUTStatements44.
MergeIPPrintWayRoutingCriteria45.
InfoprintServerPrintersfromPrintInterfaceandDefaultRouting46.
InfoprintServerPrintersfromNetSpoolandDefaultRouting47.
InfoprintServerPrintersfromPrintInterfaceandRouting(mayberepeated)48.
InfoprintServerPrintersfromNetSpoolandRouting(mayberepeated)49.
MergeInfoprintServerPrinters50.
RemoveDuplicateDEST/CLASS/FORMSRoutingSupport51.
InfoprintServerPrintersfromRouting52.
PrintInterfacePrintersThatDidNotMatchIPPrintWay53.
RenameProcessingComponentstoPreventDuplicates54.
CombineProcessingComponents55.
AssignNamestoNamelessInfoprintServerPrinters56.
UnreferencedComponents57.
MissingComponentsFollowingisadescriptionofthecontentsofeachsectionofthemigrationreport.
1.
OptionsandArgumentsUsedbythisProgramReflectsthespecificationsmadewhentheprogramwasinvoked.
2.
ConvertIPPrintWayOptionsEntriesListsmessagesfromtheconversionofindividualoptionsentries.
Ifyouspecifymorethanoneoptionsdatasetname,themigrationprogramcreatesaninstanceofthissectionforeachdataset.
3.
IdenticallyNamedDefinitionsThatDifferThemigrationprogramincludesthissectiononlywhenyouspecifymorethanoneoptionsdatasetname.
Itlistsoptionsentrieswhosenamesoccurinmorethanoneinputdatasetandwhosecontentsdifferbetweendatasets.
Themigrationprogramassignsanewnametoeachuniqueversionoftheseoptionsentries.
Itupdatesroutingentriesthatrefertotheseoptionsentriessotheyusethenewnames.
BecauseaninstallationcanrefertotheseoptionsentriesinthePRTOPTNSparameterofJCLOUTPUTstatementsorinPrintInterfaceprinterdefinitions,themigrationprogramretainsthefirstoccurrenceoftheoptionsentryusingtheoriginalname.
4.
IPPrintWayOptionsEntriesinConvertedFormatListstheresultsofthepreliminaryconversion.
Someattributevalueswillsubsequentlybeadjustedandoptionsentriesmightbedividedintoseveralcomponents.
5.
ConvertIPPrintWayRoutingEntriesListsmessagesfromtheconversionofindividualroutingentries.
Ifyouspecifymorethanoneroutingdatasetname,themigrationprogramcreatesaninstanceofthissectionforeachdataset.
6.
DefinitionsThatHaveIdenticalKeysThemigrationprogramincludesthissectiononlywhenyouspecifymorethanoneroutingdatasetname.
Itlistsroutingentrieswhosekeysoccurinmorethanoneinputdatasetandwhosecontentsdifferbetweendatasets.
Becausetherecanbeonlyoneentryperkey,themigrationprogramretainsthefirstentryforeachkey.
160z/OSV1R2.
0InfoprintServerMigration7.
IPPrintWayRoutingEntriesinConvertedFormatListstheresultsofthepreliminaryconversion.
RoutingentrieswillsubsequentlybecombinedwithNetSpoolandPrintInterfaceprinterdefinitionsorusedtocreatetheirownprinterdefinitions.
8.
ConvertPrintInterfacePrintersListsmessagesfromtheconversionofindividualprinters.
9.
PrintInterfacePrintersinConvertedFormatListstheresultsofthepreliminaryconversion.
PrintersmightsubsequentlybecombinedwithIPPrintWayroutingentriesandNetSpoolprinterdefinitions.
10.
ConvertNetSpoolOUTPUTStatementsListsmessagesfromtheconversionofindividualJCLOUTPUTstatements.
IfyouspecifymorethanonedatasetnameforJCLOUTPUTstatements,themigrationprogramcreatesaninstanceofthissectionforeachdataset.
11.
IdenticallyNamedDefinitionsThatDifferThemigrationprogramincludesthissectiononlywhenyouspecifymorethanoneJCLOUTPUTstatementsdatasetname.
ItlistsOUTPUTstatementswhosenamesoccurinmorethanoneinputdatasetandwhosecontentsdifferbetweendatasets.
ThemigrationprogramassignsanewnametoeachuniqueversionoftheseOUTPUTstatements.
ItupdatesNetSpoolprintersandoptionsentriesthatrefertotheseOUTPUTstatementssotheyusethenewnames.
12.
NetSpoolOUTPUTStatementsinConvertedFormatListstheresultsofthepreliminaryconversion.
InsubsequentstepsthemigrationprogrammightmovesomeattributesfromthesepreliminaryAllocationcomponentdefinitionsintoprinterdefinitions.
13.
DefaultOUTPUTStatementNamesListsthenameofthedefaultOUTPUTstatement,ifoneexists.
Ifyouspecifymorethanoneinputdatasettothemigrationprogram,thissectionliststhenameofthedefaultOUTPUTstatementineachinputfile.
14.
ConvertNetSpoolOptionsEntriesListsmessagesfromtheconversionofindividualoptionsentries.
Ifyouspecifymorethanoneoptionsdatasetname,themigrationprogramcreatesaninstanceofthissectionforeachdataset.
15.
IdenticallyNamedDefinitionsThatDifferThemigrationprogramincludesthissectiononlywhenyouspecifymorethanoneoptionsdatasetname.
Itlistsoptionsentrieswhosenamesoccurinmorethanoneinputdatasetandwhosecontentsdifferbetweendatasets.
Themigrationprogramassignsanewnametoeachuniqueversionoftheseoptionsentries.
ItupdatesNetSpoolprintersthatrefertotheseoptionsentriessotheyusethenewnames.
16.
NetSpoolOptionsEntriesinConvertedFormatListstheresultsofthepreliminaryconversion.
Someattributevalueswillsubsequentlybeadjusted.
OptionsentrieswhosecontentscannotbemappedtoacomponentwillbeusedtoupdateNetSpoolprinters,thendiscarded.
17.
OverridesinConvertedNetSpoolOptionsEntriesListsoptionsentriesthatincludeOVERRIDEspecificationsintheformOVERRIDE=(CLASS,DEST,FORMS).
18.
ConvertNetSpoolEnd-of-FileRulesEntriesAppendixA.
MigrationReport161Listsmessagesfromtheconversionofindividualend-of-filerulesentries.
Ifyouspecifymorethanoneend-of-filerulesdatasetname,themigrationprogramcreatesaninstanceofthissectionforeachdataset.
19.
IdenticallyNamedDefinitionsThatDifferThemigrationprogramincludesthissectiononlywhenyouspecifymorethanoneend-of-filesrulesdatasetname.
Itlistsend-of-filerulesentrieswhosenamesoccurinmorethanoneinputdatasetandwhosecontentsdifferbetweendatasets.
Themigrationprogramassignsanewnametoeachuniqueversionoftheseend-of-filerulesentries.
ItupdatesNetSpoolprintersthatrefertotheseend-of-filerulesentriessotheyusethenewnames.
20.
NetSpoolEnd-of-FileRulesEntriesinConvertedFormatListstheresultsofthepreliminaryconversion.
21.
ConvertNetSpoolPageFormatEntriesListsmessagesfromtheconversionofindividualpageformatentries.
Ifyouspecifymorethanonepageformatdatasetname,themigrationprogramcreatesaninstanceofthissectionforeachdataset.
22.
IdenticallyNamedDefinitionsThatDifferThemigrationprogramincludesthissectiononlywhenyouspecifymorethanonepageformatdatasetname.
Itlistspageformattingentrieswhosenamesoccurinmorethanoneinputdatasetandwhosecontentsdifferbetweendatasets.
Themigrationprogramassignsanewnametoeachuniqueversionofthesepageformatentries.
ItupdatesNetSpoolprintersthatrefertothesepageformatentriessotheyusethenewnames.
23.
NetSpoolPageFormatEntriesinConvertedFormatListstheresultsofthepreliminaryconversion.
InsubsequentstepsthemigrationprogrammightaddcodepagespecificationsandmightcombinetheseconvertedpageformatentrieswithspecificationsfromconvertedIPPrintWayoptionsentries.
24.
ConvertNetSpoolRoutingEntriesListsmessagesfromtheconversionofindividualroutingentries.
Ifyouspecifymorethanoneroutingdatasetname,themigrationprogramcreatesaninstanceofthissectionforeachdataset.
25.
DefinitionsThatHaveIdenticalKeysThemigrationprogramincludesthissectiononlywhenyouspecifymorethanoneroutingdatasetname.
ItlistsNetSpoolprinternames(logicalunitnames)thatoccurinmorethanoneinputdataset.
Becausetherecanbeonlyoneprinterperlogicalunitname,themigrationprogramretainsthefirstentryforeachname.
26.
NetSpoolPrintersinConvertedFormatfromRoutingEntriesListstheresultsofthepreliminaryconversion.
PrintersmightsubsequentlybecombinedwithIPPrintWayandPrintInterfaceprinterdefinitions.
27.
ConvertNetSpoolPCDSDefinitionsListsmessagesfromtheconversionofindividualprinterdefinitionsintheprint-characteristicsdataset.
Ifyouspecifymorethanoneprint-characteristicsdatasetname,themigrationprogramcreatesaninstanceofthissectionforeachprint-characteristicsdataset.
28.
DefinitionsThatHaveIdenticalKeys162z/OSV1R2.
0InfoprintServerMigrationThemigrationprogramincludesthissectiononlywhenyouspecifymorethanoneprint-characteristicsdatasetname.
ItlistsNetSpoolprinternames(logicalunitnames)thatoccurinmorethanoneinputprint-characteristicsdataset.
Becausetherecanbeonlyoneprinterperlogicalunitname,themigrationprogramretainsthefirstentryforeachname.
29.
NetSpoolPrintersinConvertedFormatfromPCDSListstheresultsofthepreliminaryconversion.
PrintersmightsubsequentlybecombinedwithIPPrintWayandPrintInterfaceprinterdefinitions.
30.
ModifyIPPrintWayPageHeightValuesPriortoOS/390V2R8,IPPrintWaysupportedtheLINECOUNT,TOPMARGIN,NOTOPMARGIN,HEADER,andNOHEADERLPRoptions.
LINECOUNTreferredtothenumberoflinesperpage,notincludingthetopmarginandheader.
InOS/390V2R8,IPPrintWaysupportstheprintway-page-height,printway-top-margin,andprint-page-headerattributes.
Theprintway-page-heightattributeincludesthetopmarginandheader.
ThemigrationprogramsetstheseattributessopagesthatIPPrintWayformatswilllookthesameinOS/390V2R8astheydidbefore.
31.
Addlpr-restrict-portstoMaintainCurrentBehaviorPriortoOS/390V2R8,theIPPrintWayLPR,bydefault,restricteditselftoports721through731.
YoucouldspecifytheUSERPORTSLPRoptiontocausetheIPPrintWayLPRtouseanyavailableport.
InOS/390V2R8,theIPPrintWayLPRusesanyavailableport,bydefault.
Youcansetthelpr-restrict-portsattributeto″yes″tocausetheIPPrintWayLPRtorestrictitselftoports721through731.
TheLPDprogramsonsomeplatforms,suchasAIX,requiretheIPPrintWayLPRtorestrictitselftotheseports.
BecausethedefaultbehaviorhasbeenreversedinOS/390V2R8,themigrationprogramexplicitlysetsthelpr-restrict-portsattributesothatIPPrintWay'sportselectionbehaviorforexistingprintersdoesnotchange.
Themigrationprogramaddslpr-restrict-ports=yestoalloptionsentriesthatdidnotincludetheUSERPORTSLPRoption.
32.
InfoprintServerComponentsfromIPPrintWayOptionsEntriesListsOS/390V2R8InfoprintServercomponentscreatedfromIPPrintWayoptionsentries.
EachIPPrintWayoptionsentrycanresultinuptothreeOS/390V2R8InfoprintServercomponents:IPPrintWayOptions,Processing,andProtocol.
Allcomponentsgeneratedfromanoptionsentryhavethesamename.
33.
Addlpr-restrict-portstoMaintainCurrentBehaviorPriortoOS/390V2R8,theIPPrintWayLPRrestricteditselftoports721through731,bydefault.
YoucouldspecifytheUSERPORTSLPRoptiontocausetheIPPrintWayLPRtouseanyavailableport.
InOS/390V2R8,theIPPrintWayLPRusesanyavailableport,bydefault.
Youcansetthelpr-restrict-portsattributeto″yes″tocausetheIPPrintWayLPRtorestrictitselftoports721through731.
TheLPDprogramsonsomeplatforms,suchasAIX,requiretheIPPrintWayLPRtorestrictitselftotheseports.
BecausethedefaultbehaviorhasbeenreversedinOS/390V2R8,themigrationprogramexplicitlysetsthelpr-restrict-portsattributesothatIPPrintWay'sportselectionbehaviorforexistingprintersdoesnotchange.
Themigrationprogramaddslpr-restrict-ports=yestoallroutingentriesthatdidnotrefertoanoptionsentry.
Themigrationprogramseparatelyadjustsoptionsentriestomaintaincurrentbehavior.
AppendixA.
MigrationReport16334.
AdjustedIPPrintWayRoutingEntriesListsIPPrintWayroutingentries.
Routingentriesthatreferredtoanoptionsentrynowincludethecomponentsgeneratedfromtheoptionsentry.
35.
AdjustedPrintInterfacePrintersListsPrintInterfaceprinters.
36.
InfoprintServerComponentsfromNetSpoolEnd-of-FileRulesEntriesListsOS/390V2R8InfoprintServerNetSpoolEnd-of-FileRulescomponentscreatedfromNetSpoolend-of-filerulesentries.
37.
InfoprintServerComponentsfromNetSpoolPageFormatEntriesListsOS/390V2R8InfoprintServerProcessingcomponentscreatedfromNetSpoolpageformatentries.
38.
NetSpoolPrintersAdjustedforPoolingListsNetSpoolprinterscreatedfromprinterdefinitionsintheNetSpoolprint-characteristicsdataset.
PrinterdefinitionstatementsthatincludemorethanoneOUTPUTstatementnamecausethemigrationprogramtocreateaprinterforeachOUTPUTstatementname.
Themigrationprogramstoresthelogicalunitnameinapoolthatreferencesalloftheprinters.
39.
NetSpoolPoolsListsNetSpoolpoolscreatedfromNetSpoolprint-characteristicsdatasetstatements.
Print-characteristicsdatasetstatementsthatincludemorethanoneOUTPUTstatementnamecausethemigrationprogramtocreateaprinterforeachOUTPUTstatementname.
Themigrationprogramstoresthelogicalunitnameinapoolthatreferencesalloftheprinters.
40.
InfoprintServerComponentsfromNetSpoolOptionsEntriesListsOS/390V2R8InfoprintServerNetSpoolOptionscomponentscreatedfromoptionsentries.
41.
NetSpoolPrintersAdjustedforPoolingListsNetSpoolprinterscreatedfromroutingandoptionsentries.
OptionsentriesthatincludemorethanoneOUTPUTstatementnamecausethemigrationprogramtocreateaprinterforeachOUTPUTstatementname.
Themigrationprogramstoresthelogicalunitnameinapoolthatreferencesalloftheprinters.
42.
NetSpoolPoolsListsNetSpoolpoolscreatedfromroutingandoptionsentries.
OptionsentriesthatincludemorethanoneOUTPUTstatementnamecausethemigrationprogramtocreateaprinterforeachOUTPUTstatementname.
Themigrationprogramstoresthelogicalunitnameinapoolthatreferencesalloftheprinters.
43.
InfoprintServerComponentsfromNetSpoolOUTPUTStatementsListsOS/390V2R8InfoprintServerAllocationcomponentscreatedfromNetSpoolOUTPUTstatements.
44.
MergeIPPrintWayRoutingCriteriaPriortoOS/390V2R8,IPPrintWayyouhadtoentervaluesforDEST,FORMS,andCLASSineachroutingentry.
InOS/390V2R8,youcanleaveoutoneormoreoftheseparametersiftheroutingentryappliestoSYSOUTdatasetswithanyvaluefortheomittedparameters.
ThemigrationprogramidentifiescaseswhereseveralroutingentriescouldbereducedtoasingleentrybyomittingoneormoreoftheDEST,FORMS,andCLASSparameters.
Themigrationprogramdoessoonlyifallofthemergedentrieshavethesamecontents.
164z/OSV1R2.
0InfoprintServerMigrationForexample,iftherearefiveroutingentries:DEST=PRTR1CLASS=JFORMS=STANDARDhostname=host1queue=queue1DEST=PRTR1CLASS=JFORMS=LETTERhostname=host1queue=queue1DEST=PRTR1CLASS=JFORMS=ENVELOPEhostname=host1queue=queue1DEST=PRTR2CLASS=JFORMS=ENVELOPEhostname=host2queue=queue1DEST=PRTR3CLASS=JFORMS=ENVELOPEhostname=host2queue=queue2wherethefirstthreeentrieshavethesamecontentsandnootherentriesexistwithDEST=PRTR1andCLASS=J,thenthefirstthreeroutingentriescanbemergedintooneprinterdefinition,withFORMSomittedintheprinterdefinition:DEST=PRTR1CLASS=Jhostname=host1queue=queue1Becausethecontentsofthelasttwoentriesdiffer(queuenameisdifferent),theentriesarenotmerged.
DEST=PRTR2CLASS=JFORMS=ENVELOPEhostname=host2queue=queue1DEST=PRTR3CLASS=JFORMS=ENVELOPEhostname=host2queue=queue245.
InfoprintServerPrintersfromPrintInterfaceandDefaultRoutingListsOS/390V2R8InfoprintServerprinterscreatedfromthecombinationofPrintInterfaceprintersandtheIPPrintWaydefaultroutingentry.
ThemigrationprogramcombinesprintersthatspecifyadestinationIPaddresswiththedefaultroutingentry,ifoneexists.
46.
InfoprintServerPrintersfromNetSpoolandDefaultRoutingListsOS/390V2R8InfoprintServerprinterscreatedfromthecombinationofNetSpoolprintersandtheIPPrintWaydefaultroutingentry.
ThemigrationprogramcombinesprintersthatspecifyadestinationIPaddresswiththedefaultroutingentry,ifoneexists.
47.
InfoprintServerPrintersfromPrintInterfaceandRoutingListsOS/390V2R8InfoprintServerprinterscreatedfromthecombinationofPrintInterfaceprintersandanIPPrintWayroutingentry.
ThemigrationprogrammatchesaprinterwitharoutingentryiftheDEST,CLASS,andFORMSvaluesintheprinterarethesameasthoseintheroutingentry.
Ifyouspecifydefaultclass,defaultforms,ordefaultdestvalueswhenyoustartthemigrationprogram,themigrationprogramincludesanextrainstanceofthissectionforeachsetofdefaultvaluesyouspecify.
Thedefaultclass,defaultforms,anddefaultdestareappliedtoPrintInterfaceprintersthatdonotincludeclass,forms,ordestspecifications.
48.
InfoprintServerPrintersfromNetSpoolandRoutingListsOS/390V2R8InfoprintServerprinterscreatedfromthecombinationofNetSpoolprintersandanIPPrintWayroutingentry.
ThemigrationprogrammatchesaprinterwitharoutingentryiftheDEST,CLASS,andFORMSvaluesintheprinterarethesameasthoseintheroutingentry.
Ifyouspecifydefaultclass,defaultforms,ordefaultdestvalueswhenyoustartthemigrationprogram,themigrationprogramincludesanextrainstanceofthissectionforeachsetofdefaultvaluesyouspecify.
Thedefaultclass,defaultforms,anddefaultdestareappliedtoNetSpoolprintersthatdonotincludeclass,formsordestspecifications.
49.
MergeInfoprintServerPrintersListsOS/390V2R8InfoprintServerprinterscreatedfromthecombinationofPrintInterfaceandNetSpoolprintersthatwerebothcombinedwiththesameIPPrintWayroutingentry.
50.
RemoveDuplicateDEST/CLASS/FORMSRoutingSupportAppendixA.
MigrationReport165IPPrintWayusessomeOS/390V2R8printerstolookuproutinginformationforSYSOUTdatasetsthatdonotspecifyadestinationIPaddress.
ItusesOS/390V2R8printerswhosedcf-routingattributeequalsyes.
AsthemigrationprogramcombinesPrintInterfaceandNetSpoolprinterswithIPPrintWayroutingentries,itsetsthedcf-routingattributeincombinationswherePrintInterfaceandNetSpooldonotoverrideanyIPPrintWaysettings.
However,thedestination,output-class,andformsattributesmustformauniquesetineachprinterwhosedcf-routingattributeequalsyes.
Themigrationprogramremovesthedcf-routingattributefromallbutoneprinterincaseswhereseveralprintershavethesamedestination,output-class,andformsattributesandhavedcf-routingequalsyes.
51.
InfoprintServerPrintersfromRoutingSomeIPPrintWayroutingentrieshavebeencombinedwithPrintInterfaceandNetSpoolprinters.
IfPrintInterfaceandNetSpooldonotoverrideanyIPPrintWaysettings,thereisnoneedtocreateaseparateprinterwiththedcf-routingattributeequalyesforIPPrintWaytouseinroutingSYSOUTdatasets.
However,themigrationprogrammustcreateOS/390V2R8printersfromroutingentriesthatcouldnotbecombinedwithPrintInterfaceandNetSpoolprinterswithdcf-routingequalyes.
52.
PrintInterfacePrintersThatDidNotMatchIPPrintWayListsV2R5PrintInterfaceprinterswithtypeIPPrintWaybutthatdidnotmatchanyIPPrintWayroutingentries.
Youshouldcorrectorremovetheseprinters.
53.
RenameProcessingComponentstoPreventDuplicatesThemigrationprogramcancreateOS/390V2R8ProcessingcomponentsfromV2R5IPPrintWayoptionsentries.
ThemigrationprogramalsocreatesOS/390V2R8ProcessingcomponentsfromV2R5NetSpoolpageformattableentries.
Incaseswhereanoptionentryandapageformattableentryhavethesamename,themigrationprogramrenamestheProcessingcomponentgeneratedfromthepageformattableentry.
TheProcessingcomponentgeneratedfromtheoptionsentrymightbereferencedusingtheJCLPRTOPTNSparametersoitmustnotberenamed.
54.
CombineProcessingComponentsThemigrationprogramcancreateOS/390V2R8ProcessingcomponentsfromV2R5IPPrintWayoptionsentries.
ThemigrationprogramalsocreatesOS/390V2R8ProcessingcomponentsfromV2R5NetSpoolpageformattableentries.
IncaseswherethemigrationprogramcreatesaprinterbycombiningaNetSpoolprinterwithanIPPrintWayroutingentry,thecombinedprintermightneedtorefertotwoProcessingcomponents.
SinceaprintercanonlyincludeoneProcessingcomponent,themigrationprogramcreatesanewProcessingcomponentthatcontainsinformationfrombothofthetwooriginalProcessingcomponents.
55.
AssignNamestoNamelessInfoprintServerPrintersOS/390V2R8printersformedfromV2R5PrintInterfaceprintersretainthenameoftheV2R5PrintInterfaceprinters.
Themigrationprogramdoesnotneedtoassignaname;however,OS/390V2R8printersformedfromV2R5NetSpoolprintersorV2R5IPPrintWayroutingentriesdon'thaveaname,sothemigrationprogramassignsone.
ForaprinterformedfromaV2R5NetSpoolprinter,themigrationprogramattemptstousethelowercaserepresentationoftheprinter'slogicalunitname.
Ifthatnameisnotunique,themigrationprogramattemptstousetheuppercaserepresentationoftheprinter'slogicalunitname.
Ifthatnameisnotunique,themigrationprogramgeneratesanameprefixedwith″is_gen″.
166z/OSV1R2.
0InfoprintServerMigrationForaprinterformedfromaV2R5IPPrintWayprinter,themigrationprogramattemptstousethelowercaserepresentationoftheprinter'sDEST/CLASS/FORMSvalues.
Ifthatnameisnotunique,themigrationprogramattemptstousetheuppercaserepresentationoftheprinter'sDEST/CLASS/FORMSvalues.
Ifthatnameisnotunique,themigrationprogramgeneratesanameprefixedwith″is_gen″.
56.
UnreferencedComponentsListscomponentsthatexistbutarenotreferencedbyaprinter.
Unreferencedcomponentsoccurbecauseanoptionsentry,OUTPUTstatement,end-of-filerulestableentry,orpageformattableentrywasnotreferencedpriortomigration.
IPPrintWayoptionsentriescanalsobereferencedinJCLusingthePRTOPTNSparameter.
ThemigrationprogramdoesnotconsiderJCLreferencesinformulatingthislist.
Youshoulddecidewhetherthelistedcomponentsarestillrequired.
Ifnot,youcandeletethem.
57.
MissingComponentsListscomponentsthatarereferencedbyaprinterbutdonotexist.
Missingcomponentsoccurbecauseanoptionsentry,OUTPUTstatement,end-of-filerulestableentry,orpageformattableentrywasmissingpriortomigration.
Youshouldcreatethemissingcomponentorremovethereferencetoit.
AppendixA.
MigrationReport167168z/OSV1R2.
0InfoprintServerMigrationAppendixB.
MigrationTablesThetablesinthisappendixshowhowthemigrationprogrammigratesprinterinformationintheIPPrintWayroutingdataset,IPPrintWayoptionsdataset,NetSpoolprint-characteristicsdataset,NetSpoolpage-formattable,andNetSpoolOUTPUTJCLstatements.
IPPrintWayRoutingDataSetThecolumnsinTable40containthefollowinginformation:vThefirstcolumnliststheISPFpanelfieldnameinanIPPrintWayroutingentry.
vThesecondcolumnliststhecorrespondingISPFpanelfieldnameinanInfoprintServerprinterdefinition.
TheISPFpanelnameprecedesthefieldname.
vThethirdcolumnliststhecorrespondingprinterattributeusedbythePIDUprogram.
Table40.
IPPrintWayRoutingEntryISPFFieldstoInfoprintServerISPFFieldsandPrinterAttributesRoutingEntryFieldNamePrinterDefinition(orComponent)FieldNamePrinterAttribute(PIDU)DESTAllocation:DESTdestinationCLASSAllocation:CLASSoutput-classFORMSAllocation:FORMSformsRetryTimeIPPrintWayOptions:Retrytimeretry-timeRetryLimitIPPrintWayOptions:Retrylimitretry-limitRetainTimeSuccessIPPrintWayOptions:Retentionperiod:successfulsuccessful-retention-periodRetainTimeFailureIPPrintWayOptions:Retentionperiod:failurefailure-retention-periodPortNumberProtocol:Protocol=directsocket:Portnumberport-numberPrintQueueProtocol:Protocol=lpr:Printqueuenameprint-queue-nameHostName/IPAddressProtocol:Protocol=IPP:PrinterIPaddressprinter-ip-addressOptionsNamePrinterDefinition:ProcessingPrinterDefinition:NetSpooloptionsPrinterDefinition:IPPrintWayoptionsPrinterDefinition:Protocolinclude-processinginclude-netspool-optionsinclude-printway-optionsinclude-protocolNetSpoolPrinterNamePrinterDefinition:NetSpoolLUnamelunameNetSpoolLUClassPrinterDefinition:LUclasseslu-classesNetSpoolDefaultPageFormatEntryPrinterDefinition:Processinginclude-processingNetSpoolEnd-of-FileRulesEntryPrinterDefinition:NetSpoolend-of-fileinclude-netspool-eof-rulesIPPrintWayOptionsDataSetThecolumnsinTable41onpage170containthefollowinginformation:CopyrightIBMCorp.
19992002169vThefirstcolumnliststheISPFpanelfieldname(orthekeywordintheLPROptionsfield)inanIPPrintWayoptionsentry.
vThesecondcolumnliststhecorrespondingISPFpanelfieldnameinanInfoprintServerprinterdefinition.
TheISPFpanelnameprecedesthefieldname.
vThethirdcolumnliststhecorrespondingprinterattributeusedbythePIDUprogram.
Table41.
IPPrintWayOptionsEntryISPFFieldstoInfoprintServerISPFFieldsandPrinterAttributesOptionsEntryFieldNamePrinterDefinition(orComponent)FieldNamePrinterAttribute(PIDU)Exits:RecordIPPrintWayOptions:Exits:Recordrecord-exitExits:BeginDataSetIPPrintWayOptions:Exits:Begindatasetbegin-dataset-exitExits:EndDataSetIPPrintWayOptions:Exits:Enddatasetend-dataset-exitTransGroup:JobIPPrintWayOptions:Datasetgrouping:Job(noattributesgenerated)TransGroup:Job,ConcatenateIPPrintWayOptions:Datasetgrouping:Concatenatejobdataset-grouping=concatenate-jobTransGroup:DataSetIPPrintWayOptions:Datasetgrouping:Nonedataset-grouping=nonePrinterSetupParametersIPPrintWayOptions:Documentheaderdocument-headerIPPrintWayLPROptionsBIG5Processing:Double-bytetranslatetable=1(BIG5)db_translate_table=big5BINARYIPPrintWayOptions:Formatting:Formatting=1(None)printway-formatting=noneBURSTProtocol:Printbannerpage(selected)lpr-print-banner=yesCCIPPrintWayOptions:Formatting:Carriagecontroltype=3(ANSI)carriage-control-type=ansiCFFIRSTProtocol:lprProcessingOptions:Mode=1(Controlfilefirst)lpr-mode=control-file-firstCLASSProtocol:lprProcessingOptions:Printbannerpage=yes:Bannerclasslpr-banner-classDELFFIPPrintWayOptions:Formatting:Deleteformfeed=(noentry)delete-form-feed=bothDELFFBOTHIPPrintWayOptions:Formatting:Deleteformfeed=4(Both)delete-form-feed=bothDELFFLEADINGIPPrintWayOptions:Formatting:Deleteformfeed=2(Leading)delete-form-feed=leadingDELFFTRAILINGIPPrintWayOptions:Formatting:Deleteformfeed=3(Trailing)delete-form-feed=trailingEUCKANJIProcessing:Double-bytetranslationtable=2(EUCKANJI)db_translate_table=euckanjiFCBIPPrintWayOptions:Formatting:Formatting=4(UseFCB)printway-formatting=use-fcbFILTERProtocol:Printfunctionlpr-print-functionHANGEULProcessing:Double-bytetranslationtable=3(HANGEUL)db_translate_table=hangeul170z/OSV1R2.
0InfoprintServerMigrationTable41.
IPPrintWayOptionsEntryISPFFieldstoInfoprintServerISPFFieldsandPrinterAttributes(continued)OptionsEntryFieldNamePrinterDefinition(orComponent)FieldNamePrinterAttribute(PIDU)HEADERProcessing:IPPrintWayPagination:Printpageheader(selected)print-page-header=yesprintway-page-heightIBMKANJIProcessing:Double-bytetranslationtable=4(IBMKANJI)db_translate_table=ibmkanjiINDENTProtocol:lprProcessingOptions:Indentlpr-indentJIS78JKASCIIProcessing:Double-bytetranslationtable=5(JIS78JKASCII)db_translate_table=jis78kj-asciiJIS78JKJISROMANProcessing:Double-bytetranslationtable=6(JIS78JKJISROMAN)db_translate_table=jis78kj-jisromanJIS83JKASCIIProcessing:Double-bytetranslationtable=7(JIS83JKASCII)db_translate_table=jis83kj-asciiJIS83JKJISROMANProcessing:Double-bytetranslationtable=8(JIS83JKJISROMAN)db_translate_table=jis83kj-jisromanJOBProtocol:lprProcessingOptions:Printbannerpage=yes:Bannerjobnamelpr_banner_job_nameKSC5601Processing:Double-bytetranslationtable=9(KSC5601)db_translate_table=ksc5601LANDSCAPEIPPrintWayOptions:Formatting:PostScriptheader=3(Landscape)printway-postscript=landscapeIPPrintWayOptions:Formatting:PostScriptheader=4(Alwayslandscape)printway-postscript=always-landscapeLINECOUNTProcessing:IPPrintWayPagination:Pagination(selected)printway-page-heightprintway-paginationLINETERMIPPrintWayOptions:Formatting:Lineterminationline-terminationLPDSIZEProcessing:Maximumdocumentsizemaximum-document-sizeMAXSENDProcessing:Maximumdocumentsizemaximum-document-sizeNAMEProtocol:lprProcessingOptions:Filenamelpr-filenameNOBINARY(noattributesgenerated)NOBURSTProtocol:lprProcessingOptions:Printbannerpage(notselected)lpr-print-banner=noNOCCIPPrintWayOptions:Formatting:Carriagecontroltype=1(None)carriage-control-type=noneNOEOFLFIPPrintWayOptions:Formatting:OmitlineterminationatEOF(selected)omit-line-termination-at-eof=yesNOHEADERProcessing:IPPrintWayPagination:Printpageheader(notselected)print-page-header=noprintway-page-heightNOLINECOUNTProcessing:IPPrintWayPagination:Pagination(notselected)printway-pagination=suppressNOPOSTSCRIPTIPPrintWayOptions:Formatting:PostScriptheader=2(Ignore)printway-postscript=ignore-headerAppendixB.
MigrationTables171Table41.
IPPrintWayOptionsEntryISPFFieldstoInfoprintServerISPFFieldsandPrinterAttributes(continued)OptionsEntryFieldNamePrinterDefinition(orComponent)FieldNamePrinterAttribute(PIDU)printway-postscript=always-landscapeNOTOPMARGINProcessing:IPPrintWayPagination:Margins:Top(noentry)printway-page-heightprintway-top-marginPOSTSCRIPTIPPrintWayOptions:Formatting:PostScriptheader=1(Add)printway-postscript=add-headerRECORDProtocol:lprProcessingOptions:Mode=4(RemotePSF)lpr-mode=to-remote-psfSCHINESEProcessing:Double-bytetranslationtable=10(SCHINESE)db_translate_table=schineseSJISKANJIProcessing:Double-bytetranslationtable=11(SJISKANJI)db_translate_table=sjiskanjiSOSIProcessing:IPPrintWayattributes:SOSImode=(noentry)printway-sosi-mode=asciiSOSIASCIIProcessing:IPPrintWayattributes:SOSImode=2(ASCII)printway-sosi-mode=asciiSOSIEBCDICProcessing:IPPrintWayattributes:SOSImode=4(EBCDIC)printway-sosi-mode=ebcdicSOSINONEProcessing:IPPrintWayattributes:SOSImode=1(None)printway-sosi-mode=noneSOSISPACEProcessing:IPPrintWayattributes:SOSImode=3(Space)printway-sosi-mode=spaceSTREAMProtocol:lprProcessingOptions:Mode=3(Stream)lpr-mode=streamingTCHINESEProcessing:Double-bytetranslationtable=12(TCHINESE)db_translate_table=tchineseTDCHARIPPrintWayOptions:Formatting:Transparentdatacharacter(selected)transparent-data-characterTIMEOUTIPPrintWayOptions:Responsetimeoutresponse-timeoutTITLEProtocol:lprProcessingOptions:Titlelpr-titleTOPMARGINProcessing:IPPrintWayPagination:Pagination:Margins:Topprintway-page-heightprintway-top-marginTRANSLATETABLEProcessing:Translationdatasetqualifiertranslation-dataset-qualifierUSERProtocol:lprProcessingOptions:OwnerownerUSERPORTSProtocol:lprProcessingOptions:Restrictports(notselected)lpr-restrict-ports=noWIDTHProtocol:lprProcessingOptions:Widthlpr-widthXLATETABLEProcessing:Translationdatasetqualifiertranslation-dataset-qualifierNetSpoolPrintCharacteristicsDataSet(PCDS)ThecolumnsinTable42onpage173containthefollowinginformation:vThefirstcolumnlistskeywordsinaNetSpoolprinterdefinition.
172z/OSV1R2.
0InfoprintServerMigrationvThesecondcolumnliststhecorrespondingISPFpanelfieldnameinanInfoprintServerprinterdefinition.
TheISPFpanelnameprecedesthefieldname.
vThethirdcolumnliststhecorrespondingprinterattributeusedbythePIDUprogram.
Table42.
NetSpoolPrinterDefinitionKeywordstoInfoprintServerISPFFieldsandPrinterAttributesPrinterDefinitionKeywordPrinterDefinition(orComponent)FieldNamePrinterAttribute(PIDU)BURSTAllocation:Spoolallocationvalues:BURST=1(Yes)burster-trimmer-stackerCHARSAllocation:ResourceRelatedValues:CharactersetscharsCOPIESAllocation:Othervalues:CopiescopiesCOPYGRPSAllocation:Othervalues:Copygroupcopy-groupDATAFMTNetSpoolOptions:Formatting:Recordsizemaximum-record-sizeNetSpoolOptions:Formatting=2(Standard)netspool-formattingNetSpoolOptions:Formatting:RECFMrecfmDESTAllocation:Spoolallocationvalues:DESTdestinationAllocation:Spoolallocationvalues:JESnodejes-nodeDESTUSIDAllocation:Spoolallocationvalues:DESTdestinationDPFNAMEPrinterDefinition:Processinginclude-processingEOFNAMEPrinterDefinition:NetSpoolend-of-fileinclude-netspool-eof-rulesFCBAllocation:Spoolallocationvalues:FCBforms-control-bufferFLASHAllocation:Spoolallocationvalues:FLASHnameflash-nameFLASHCNTAllocation:Spoolallocationvalues:FLASHcountflash-countHOLDAllocation:Spoolallocationvalues:HOLDholdLUCLASSPrinterDefinition:LUclasseslu-classesMODIFTRCNotApplicable(notsupported)MODIFYNotApplicable(notsupported)OUTPUTPrinterDefinition:Allocationinclude-allocationPRINTERNAMEPrinterDefinition:NetSpoolLUnamelunameSEGMENTAllocation:Spoolallocationvalues:SEGMENTsegment-pagesSYSOUTCLAllocation:Spoolallocationvalues:CLASSoutput-classSYSOUTFRAllocation:Spoolallocationvalues:FORMSformsSYSOUTWRAllocation:Spoolallocationvalues:WRITERjes-writerUCSAllocation:Spoolallocationvalues:UCSuniversal-character-setNetSpoolOUTPUTStatementsThecolumnsinTable43onpage174containthefollowinginformation:vThefirstcolumnliststheparameternameinanOUTPUTJCLstatementinaNetSpoolstartupprocedure.
vThesecondcolumnliststhecorrespondingISPFpanelfieldnameinanInfoprintServerprinterdefinition.
TheISPFpanelnameprecedesthefieldname.
AppendixB.
MigrationTables173vThethirdcolumnliststhecorrespondingprinterattributeusedbythePIDUprogram.
Table43.
NetSpoolOUTPUTJCLStatementParameterstoInfoprintServerISPFFieldsandPrinterAttributesOUTPUTJCLStatementParameterNamePrinterDefinition(orComponent)FieldNamePrinterAttribute(PIDU)ADDRESSAllocation:ValuesforSeparatorPages:Addressaddress-textBUILDINGAllocation:ValuesforSeparatorPages:Buildingbuilding-textBURSTAllocation:Spoolallocationvalues:BURST=1(Yes)burster-trimmer-stackerCHARSAllocation:ResourceRelatedValues:CharactersetscharsCKPTLINENotApplicable(notsupported)CKPTPAGEAllocation:OtherValues:Checkpointpagescheckpoint-pagesCKPTSECAllocation:OtherValues:Checkpointsecondscheckpoint-secondsCLASSAllocation:Spoolallocationvalues:CLASSoutput-classCOLORMAPAllocation:OtherValues:Colormapcolor-mapCOMPACTNotApplicable(notsupported)COMSETUPAllocation:OtherValues:Comsetupmembercom-setup-memberCONTROLNotApplicable(notsupported)COPIESAllocation:OtherValues:CopiescopiesAllocation:OtherValues:Copygroupcopy-groupDATACKUNBLOCKAllocation:ErrorReportingValues:Printerrorreporting=2(All)print-error-reporting=allBLOCKAllocation:ErrorReportingValues:Printerrorreporting=1(None)print-error-reporting=noneBLKCHARAllocation:ErrorReportingValues:Printerrorreporting=4(Position)print-error-reporting=positionBLKPOSAllocation:ErrorReportingValues:Printerrorreporting=3(Character)print-error-reporting=characterDEFAULTNotApplicable(supported,butdoesnotmaptoattribute)DEPTAllocation:ValuesforSeparatorPages:Departmentdepartment-textDESTAllocation:Spoolallocationvalues:DESTdestinationAllocation:Spoolallocationvalues:JESnodejes-nodeProtocol:PrinterIPaddressprinter-ip-addressDPAGELBLAllocation:OtherValues:Labeldatapageslabel-data-pagesDUPLEXNOAllocation:OtherValues:Duplex=1(Simplex)duplex=noNORMALAllocation:OtherValues:Duplex=2(Duplex)duplex=yesTUMBLEAllocation:OtherValues:Duplex=3(Tumble)duplex=tumbleFCBAllocation:Spoolallocationvalues:FCBforms-control-buffer174z/OSV1R2.
0InfoprintServerMigrationTable43.
NetSpoolOUTPUTJCLStatementParameterstoInfoprintServerISPFFieldsandPrinterAttributes(continued)OUTPUTJCLStatementParameterNamePrinterDefinition(orComponent)FieldNamePrinterAttribute(PIDU)FLASHAllocation:Spoolallocationvalues:FLASHcountflash-countAllocation:Spoolallocationvalues:FLASHnameflash-nameFORMDEFAllocation:ResourceRelatedValues:Formdefinitionform-definitionFORMLENAllocation:OtherValues:JESformlengthjes-form-lengthFORMSAllocation:Spoolallocationvalues:FORMSformsFSSDATANotApplicable(notsupported)GROUPIDAllocation:Spoolallocationvalues:GROUPIDgroup-identifierINDEXNotApplicable(notsupported)INTRAYAllocation:ResourceRelatedValues:Inputtrayinput-tray-numberJESDSNotApplicable(notsupported)LINDEXNotApplicable(notsupported)LINECTAllocation:Spoolallocationvalues:LINECTjes-maximum-line-countMODIFYNotApplicable(notsupported)NAMEAllocation:ValuesforSeparatorPages:Namename-textNOTIFYAllocation:OtherValues:NotifynotifyOFFSETXBAllocation:ResourceRelatedValues:Imageshiftx-directionbackx-image-shift-backOFFSETXFAllocation:ResourceRelatedValues:Imageshiftx-directionfrontx-image-shift-frontOFFSETYBAllocation:ResourceRelatedValues:Imageshifty-directionbacky-image-shift-backOFFSETYFAllocation:ResourceRelatedValues:Imageshifty-directionfronty-image-shift-frontOUTBINAllocation:ResourceRelatedValues:Outputbinoutput-bin-numberOUTDISPAllocation:Spoolallocationvalues:OUTDISPnormal-output-dispositionOVERLAYBAllocation:ResourceRelatedValues:OverlayBackoverlay-backOVERLAYFAllocation:ResourceRelatedValues:Overlayfrontoverlay-frontOVFLNotApplicable(notsupported)PAGEDEFAllocation:ResourceRelatedValues:Pagedefinitionpage-definitionPIMSGAllocation:ErrorReportingValues:Errordisposition:Printerrormessages(selected)print-error-messagesAllocation:ErrorReportingValues:Errordisposition:Printerrormessages:Maximummessagesprint-error-messages-maximumPORTNOProtocol:Portnumberport-numberPRMODEAllocation:Spoolallocationvalues:PRMODEprocess-modeAppendixB.
MigrationTables175Table43.
NetSpoolOUTPUTJCLStatementParameterstoInfoprintServerISPFFieldsandPrinterAttributes(continued)OUTPUTJCLStatementParameterNamePrinterDefinition(orComponent)FieldNamePrinterAttribute(PIDU)PRTERRORAllocation:ErrorReportingValues:Errordispositionerror-dispositionPRTOPTNSPrinterDefinition:IPPrintWayoptionsinclude-printway-optionsPRTQUEUEProtocol:Printqueuenameprint-queue-namePRTYAllocation:Spoolallocationvalues:PRTYjes-priorityRESFMTAllocation:OtherValues:ResolutionresolutionRETAINFIPPrintWayOptions:Retentionperiod:Failurefailure-retention-periodRETAINSIPPrintWayOptions:Retentionperiod:Successfulsuccessful-retention-periodRETRYLIPPrintWayOptions:Retrylimitretry-limitRETRYTIPPrintWayOptions:Retrytimeretry-timeROOMAllocation:ValuesforSeparatorPages:Roomroom-textSYSAREAAllocation:OtherValues:Restrictprintablearearestrict-printable-areaTHRESHLDAllocation:Spoolallocationvalues:THRESHLDjes-thresholdTITLEAllocation:ValuesforSeparatorPages:Titletitle-textTRCAllocation:OtherValues:Restrictprintablearea:Tablesreferencecharacters(selected)table-reference-charactersUCSAllocation:Spoolallocationvalues:UCSuniversal-character-setUSERDATAAllocation:Spoolallocationvalues:USERDATAuserdataUSERLIBAllocation:ResourceRelatedValues:Resourcelibraryresource-libraryWRITERAllocation:Spoolallocationvalues:WRITERjes-writer176z/OSV1R2.
0InfoprintServerMigrationNetSpoolPage-FormatTableThecolumnsinTable40onpage169containthefollowinginformation:vThefirstcolumnlistsmacrokeywordsusedtocreatetheNetSpoolpage-formattable.
vThesecondcolumnliststhecorrespondingISPFpanelfieldnameinanInfoprintServerprinterdefinition.
TheISPFpanelnameprecedesthefieldname.
vThethirdcolumnliststhecorrespondingprinterattributeusedbythePIDUprogram.
Table44.
NetSpoolPage-FormatTableKeywordstoInfoprintServerISPFFieldsandPrinterAttributesPage-FormatEntryKeywordPrinterDefinition(orComponent)FieldNamePrinterAttribute(PIDU)BMProcessing:NetSpoolSCS-to-LineConversion:Margins:Bottomscs-bottom-marginHTProcessing:NetSpoolSCS-to-LineConversion:Tabs:Horizontalscs-horizontal-tabsLMProcessing:NetSpoolSCS-to-LineConversion:Margins:Leftscs-left-marginMPLProcessing:NetSpoolSCS-to-LineConversion:Pagelengthscs-maximum-page-lengthMPPProcessing:NetSpoolSCS-to-LineConversion:Linelengthscs-maximum-line-lengthRMProcessing:NetSpoolSCS-to-LineConversion:Margins:Rightscs-right-marginTMProcessing:NetSpoolSCS-to-LineConversion:Margins:Topscs-top-marginVTProcessing:NetSpoolSCS-to-LineConversion:Tabs:Verticalscs-vertical-tabsNote:ThemigrationprogramcreatesaV2R8processingcomponentforeachV2R5pageformattableentry.
AppendixB.
MigrationTables177178z/OSV1R2.
0InfoprintServerMigrationAppendixC.
AccessibilityAccessibilityfeatureshelpauserwhohasaphysicaldisability,suchasrestrictedmobilityorlimitedvision,tousesoftwareproductssuccessfully.
Themajoraccessibilityfeaturesinz/OSenableusersto:vUseassistivetechnologiessuchasscreen-readersandscreenmagnifiersoftwarevOperatespecificorequivalentfeaturesusingonlythekeyboardvCustomizedisplayattributessuchascolor,contrast,andfontsizeUsingAssistiveTechnologiesAssistivetechnologyproducts,suchasscreen-readers,functionwiththeuserinterfacesfoundinz/OS.
Consulttheassistivetechnologydocumentationforspecificinformationwhenusingittoaccessz/OSinterfaces.
KeyboardNavigationoftheUserInterfaceUserscanaccessz/OSuserinterfacesusingTSO/EorISPF.
Refertoz/OSTSO/EPrimer,z/OSTSO/EUser'sGuide,andz/OSISPFUser'sGuideVolumeIforinformationaboutaccessingTSO/EandISPFinterfaces.
TheseguidesdescribehowtouseTSO/EandISPF,includingtheuseofkeyboardshortcutsorfunctionkeys(PFkeys).
EachguideincludesthedefaultsettingsforthePFkeysandexplainshowtomodifytheirfunctions.
CopyrightIBMCorp.
19992002179||||||||||||||||||||||180z/OSV1R2.
0InfoprintServerMigrationNoticesThisinformationwasdevelopedforproductsandservicesofferedintheU.
S.
A.
IBMmaynotoffertheproducts,services,orfeaturesdiscussedinthisdocumentinothercountries.
ConsultyourlocalIBMrepresentativeforinformationontheproductsandservicescurrentlyavailableinyourarea.
AnyreferencetoanIBMproduct,program,orserviceisnotintendedtostateorimplythatonlythatIBMproduct,program,orservicemaybeused.
Anyfunctionallyequivalentproduct,program,orservicethatdoesnotinfringeanyIBMintellectualpropertyrightmaybeusedinstead.
However,itistheuser'sresponsibilitytoevaluateandverifytheoperationofanynon-IBMproduct,program,orservice.
IBMmayhavepatentsorpendingpatentapplicationscoveringsubjectmatterdescribedinthisdocument.
Thefurnishingofthisdocumentdoesnotgiveyouanylicensetothesepatents.
Youcansendlicenseinquiries,inwriting,to:IBMDirectorofLicensingIBMCorporationNorthCastleDriveArmonk,NY10504-1785U.
S.
A.
Forlicenseinquiriesregardingdouble-byte(DBCS)information,contacttheIBMIntellectualPropertyDepartmentinyourcountryorsendinquiries,inwriting,to:IBMWorldTradeAsiaCorporationLicensing2-31Roppongi3-chome,Minato-kuTokyo106,JapanThefollowingparagraphdoesnotapplytotheUnitedKingdomoranyothercountrywheresuchprovisionsareinconsistentwithlocallaw:INTERNATIONALBUSINESSMACHINESCORPORATIONPROVIDESTHISPUBLICATION"ASIS"WITHOUTWARRANTYOFANYKIND,EITHEREXPRESSORIMPLIED,INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFNON-INFRINGEMENT,MERCHANTABILITYORFITNESSFORAPARTICULARPURPOSE.
Somestatesdonotallowdisclaimerofexpressorimpliedwarrantiesincertaintransactions,therefore,thisstatementmaynotapplytoyou.
Thisinformationcouldincludetechnicalinaccuraciesortypographicalerrors.
Changesareperiodicallymadetotheinformationherein;thesechangeswillbeincorporatedinneweditionsofthepublication.
IBMmaymakeimprovementsand/orchangesintheproduct(s)and/ortheprogram(s)describedinthispublicationatanytimewithoutnotice.
Anyreferencesinthisinformationtonon-IBMWebsitesareprovidedforconvenienceonlyanddonotinanymannerserveasanendorsementofthoseWebsites.
ThematerialsatthoseWebsitesarenotpartofthematerialsforthisIBMproductanduseofthoseWebsitesisatyourownrisk.
IBMmayuseordistributeanyoftheinformationyousupplyinanywayitbelievesappropriatewithoutincurringanyobligationtoyou.
CopyrightIBMCorp.
19992002181Licenseesofthisprogramwhowishtohaveinformationaboutitforthepurposeofenabling:(i)theexchangeofinformationbetweenindependentlycreatedprogramsandotherprograms(includingthisone)and(ii)themutualuseoftheinformationwhichhasbeenexchanged,shouldcontact:IBMCorporationMailDrop001WBoulder,CO80301U.
S.
ASuchinformationmaybeavailable,subjecttoappropriatetermsandconditions,includinginsomecases,paymentofafee.
ThelicensedprogramdescribedinthisinformationandalllicensedmaterialavailableforitareprovidedbyIBMundertermsoftheIBMCustomerAgreement,IBMInternationalProgramLicenseAgreement,oranyequivalentagreementbetweenus.
TrademarksThefollowingtermsappearinthispublicationandareeithertrademarksorregisteredtrademarksofInternationalBusinessMachinesCorporationintheUnitedStates,inothercountries,orboth:AFPAIXApplicationSystem/400CICSeNetworkIBMIBMEserverIMSIMS/ESAInfoprintIntelligentPrinterDataStreamIPPrintWayIPDSLanguageEnvironmentMVS/ESANetSpoolOpenEditionOperatingSystem/2OS/2OS/390OS/400PrintServicesFacilityPrintWayRACFRETAINRS/6000S/390VTAMWIN-OS/2z/OSz/OS.
ez/VMzSeries182z/OSV1R2.
0InfoprintServerMigration|ThefollowingtermsappearinthispublicationandareeithertrademarksorregisteredtrademarksofsubsidiariesofInternationalBusinessMachinesCorporationintheUnitedStates,inothercountries,orboth:vFreelanceisatrademarkofLotusDevelopmentCorporation.
LotusisaregisteredtrademarkofLotusDevelopmentCorporation.
ThefollowingtermsappearinthispublicationandareeithertrademarksorregisteredtrademarksofothercompaniesintheUnitedStates,inothercountries,orboth:vJavaisaregisteredtrademarkofSunMicrosystems,Inc.
vMCSisaregisteredtrademarkofIntel.
vMicrosoft,Windows,andWindowsNTareregisteredtrademarksofMicrosoftCorporation.
vUNIXisaregisteredtrademarkofTheOpenGroupintheUnitedStatesandothercountries.
Othercompany,product,andservicenamesmaybetrademarksorservicemarksofothers.
Notices183184z/OSV1R2.
0InfoprintServerMigrationBibliographyThissectionlistspublicationsthatmaybehelpfultoyouasyouconfigureanduseInfoprintServer.
InfoprintServerTitleOrderNumberInfoprintServerTransformsLicensedProgramSpecificationsG544-5797z/OSInfoprintServerCustomizationS544-5744z/OSInfoprintServerIntroductionS544-5742z/OSInfoprintServerMessagesandDiagnosisG544-5747z/OSInfoprintServerMigrationG544-5743z/OSInfoprintServerOperationandAdministrationS544-5745z/OSInfoprintServerUser'sGuideS544-5746InfoprintServerforz/OSImplementationRedbookSG24–6234PrintServicesFacilityforOS/390TitleOrderNumberAFPConversionandIndexingFacility:User'sGuideS544-5285PSFforOS/390&z/OS:CustomizationS544-5622PSFforOS/390&z/OS:DiagnosisG544-5623PSFforOS/390&z/OS:DownloadforOS/390S544-5624PSFforOS/390&z/OS:IntroductionG544-5625PSFforOS/390&z/OS:MessagesandCodesG544-5627PSFforOS/390&z/OS:User'sGuideS544-5630AdvancedFunctionPresentation(AFP)TitleOrderNumberIBMPrintingSystems:PrinterInformationS544-5750IBMPrintingSystems:PrinterSummaryS544-5749AFP:ProgrammingGuideandLineDataReferenceS544-3884IBMAFPFonts:FontSummaryforAFPFontCollectionS544-5633IBMAFPFonts:FontSummaryforAFPFontCollectionS544-5633IBMDataStreamandObjectArcitectures:BarCodeObjectContentArchitectureReferenceS544–3766IBMDataStreamandObjectArcitectures:IOCAReferenceSC31–6805IBMPagePrinterFormattingAid:User'sGuideS544-5284CopyrightIBMCorp.
19992002185||||||InfoprintManagerforAIXandWindowsTitleOrderNumberIBMInfoprintColor130PlusInstallationPlanningGuideG544-5771IBMInfoprintManager:ReferenceS544-5475IBMInfoprintManagerforAIX:Administrator'sGuideS544-5595z/OSVersion1Release2TitleOrderNumberz/OSC/C++ProgrammingGuideSC09-4765z/OSC/C++Run-TimeLibraryReferenceSA22-7821z/OSCommunicationsServer:IPandSNACodesSC31-8791z/OSCommunicationsServer:IPApplicationProgrammingInterfaceGuideSC31-8788z/OSCommunicationsServer:IPConfigurationGuideSC31-8775z/OSCommunicationsServer:IPConfigurationReferenceSC31-8776z/OSCommunicationsServer:IPMigrationGC31-8773z/OSCommunicationsServer:SNADiagnosisVol1TechniquesandProceduresLY43-0088z/OSCommunicationsServer:SNADiagnosisVol2FFSTDumpsandtheVITLY43-0089z/OSCommunicationsServer:SNAMessagesSC31-8790z/OSCommunicationsServer:SNANetworkImplementationGuideSC31-8777z/OSCommunicationsServer:SNAOperationSC31-8779z/OSCommunicationsServer:SNAProgrammingSC31-8829z/OSCommunicationsServer:SNAResourceDefinitionReferenceSC31-8778z/OSDistributedFileServiceSMBAdministrationSC24-5918z/OSInformationRoadmapSA22-7500z/OSISPFDialogDeveloper'sGuideandReferenceSC34-4821z/OSJES2CommandsSA22-7526z/OSJES2InitializationandTuningGuideSA22-7532z/OSJES2InitializationandTuningReferenceSA22-7533z/OSJES3CommandsSA22-7540z/OSJES3InitializationandTuningGuideSA22-7549z/OSJES3InitializationandTuningReferenceSA22-7550z/OSLanguageEnvironmentDebuggingGuideGA22-7560z/OSLanguageEnvironmentRun-TimeMessagesSA22-7566z/OSLanguageEnvironmentProgrammingGuideSA22-7561z/OSMVSDiagnosis:ToolsandServiceAidsGA22-7589z/OSMVSInitializationandTuningGuideSA22-7591z/OSMVSInitializationandTuningReferenceSA22-7592z/OSMVSJCLReferenceSA22-7597z/OSMVSProductManagementSA22-7603186z/OSV1R2.
0InfoprintServerMigration||||||||||||||||||||TitleOrderNumberz/OSMVSProgramming:AuthorizedAssemblerServicesReferenceALE-DYNSA22-7609z/OSMVSProgramming:AuthorizedAssemblerServicesReferenceENF-IXGSA22-7610z/OSMVSProgramming:AuthorizedAssemblerServicesReferenceLLA-SDUSA22-7611z/OSMVSProgramming:AuthorizedAssemblerServicesReferenceSET-WTOSA22-7612z/OSandz/OS.
ePlanningforInstallationGA22-7504z/OSProgramDirectoryGI10-0670z/OSSDSFOperationandCustomizationSA22-7670z/OSSecurityServerRACFGeneralUser'sGuideSA22-7685z/OSSecurityServerRACFSecurityAdministrator'sGuideSA22-7683z/OSSummaryofMessageChangesSA22-7505z/OSUNIXSystemServicesCommandReferenceSA22-7802z/OSUNIXSystemServicesMessagesandCodesSA22-7807z/OSUNIXSystemServicesPlanningGA22-7800z/OSUNIXSystemServicesUser'sGuideSA22-7801CICSTitleOrderNumberCICSCustomizationGuideSC34-5706CICSDiagnosisReferenceLY33-6097CICSResourceDefinitionGuideSC34-5722CICSSuppliedTransactionsSC34-5724IMS/ESAVersion6TitleOrderNumberIMS/ESAAdministrationGuide:SystemSC26-8730IMS/ESAAdministrationGuide:TransactionManagerSC26-87313270andSNADataStreamsTitleOrderNumberIBM3270InformationDisplaySystemDataStreamProgrammer'sReferenceGA23–0059IBM3270InformationDisplaySystem3274ControlUnitDescriptionandProgrammer'sReferenceGA23–0061IBM3270InformationDisplaySystemReferenceSummaryGX20–1878IBM3270KanjiDataStreamsGA18–2980Bibliography187||||||||||||TitleOrderNumberIPDSandSCSTechnicalReferenceS544–5312SystemsNetworkArchitecture:SessionsBetweenLogicalUnitsGC20–1868188z/OSV1R2.
0InfoprintServerMigration||IndexSpecialCharacters/etcdirectory,changes122/etc/Printsrv122/usr/lpp/Printsrv/samplesdirectory138/vardirectory,changes122/var/Printsrv122/var/Printsrv/printers/directory,exampleofmigrating149AAbortPrintFileAPIfunction110accessibility179address-textjobattribute128administrationconsiderations2AFPDrivernotpartofInfoprintServer,description14AFPtoPCLtransform,description62AFPtoPDFtransform,description62AFPtoPostScripttransform,description62AFPViewernotpartofInfoprintServer,description14afp2pclcommand139afp2pcl.
dll123afp2pdfcommand139afp2pdf.
dll123afp2pscommand139afp2ps.
dll123AIX,transformingdataremotely,description68ANFGPWFLmacro135ANFQINIT136ANFUEXTPmacro135ANFUXBD3136ANFUXRT2136ANFUXRT3136ANFUXRT4136ANFWPROCprocedure135AOP_SAP2AFP_RESOURCESenvironmentvariable113aopapi.
h138AOPBATCH134AOPCPETC136aopd.
conf111,138aopd.
confconfigurationFile111AOPJAUTH136AOPMAILERenvironmentvariable113aopmigcommand139,144AOPMIGRT136AOPMIGRTsampleJCL151AOPMIGRX136AOPOPTIONSenvironmentvariable113AOPPIDU136AOPPIDUsampleJCL154AOPPRINTJCLprocedure,description72AOPPRINTprocedure135AOPPRINT,relationshiptoPrintInterfacesubsystem42AOPRACF136aoprform.
conf138aoprform.
dll123AOPSAPD_CONFenvironmentvariable113aopsapd.
conf138aopsapd.
confconfigurationFile111aopstartcommand139AOPSTARTprocedure135AOPSTARTprocedureenhancements,description15AOPSTARTprocedure,changes133,134aopstopcommand139AOPSTOPprocedure135AOPSTOPprocedureenhancements,description15AOPSTOPprocedure,changes133,134AOPXFD_CONFenvironmentvariable113aopxfd.
conf111,138aopxfd.
confconfigurationFile111AOX2PCLJ136AOX2PDFJ137AOX2PSJ137AOXCF30J136AOXFONTS136APIfunctions110API,description80APIJPJCLprocedure135APIJPTD1137APIJPTD2137APIJUBF3137APIJUGEX137APIPP1X2macro113,135APIPPDPFmacro135APIPPEFMmacro135applicationdevelopmentconsiderations3ApplicationProgrammingInterface,description80auditingconsiderations3awkcommand155Bbarcode.
tabconfigurationFile112batchapplications,subsystemfor42BeginEnumJobsAPIfunction110BeginEnumPrintersAPIfunction110BeginningofFileexitfor3270114BufferSizeRequiredAPIfunction110CCancelJobAPIfunction110charsjobattribute128CLASS,DEST,FORMSroutingcriteria,description94class,specifyingtoaopmig144CLASSPATHenvironmentvariable113ClosePrintFileAPIfunction110CoaxPrinterSupportfeature,description104codepageconversioninIPPrintWay,description96coexistence,definition1colortransformrequirements40CopyrightIBMCorp.
19992002189color-profileattribute40color-rendering-intentattribute40color-toner-saverattribute40commands,UNIX,changes139commonmigrationactivities4components,deletingunused156components,missing,creating156configurationfiles,changes111connectiontimeout,IPPrintWayenhancement29connection-timeoutprinterattribute130Copiesfield125copiesjobattribute128copiesprinterattribute130copysupportinIPPrintWay,description17copysupportinPrintInterface,description36CreatePrintFileAPIfunction110customizationgeneralconsiderations3Ddatasets,changes112DDJCLstatement,changes126,127DEFAULT127defaultclass,specifyingtoaopmig144defaultdest,specifyingtoaopmig147defaultforms,specifyingtoaopmig145defaultvalues,specifyingmultipletimes148delete-form-feedprinterattribute130DEST,CLASS,FORMSroutingcriteria,description94dest,specifyingtoaopmig147DEST=IP127developingamigrationstrategy2disability179DISPLAYcommand132DLLfilter123Documentheaderfield22Documenttrailerfield22duplicateentities,howaopmighandles148dynamicallocationinPrintInterface,description71dynamicallocationsupportinNetSpool,description87Ee-mailsupportinIPPrintWay,description18editingthePrinterInventory155email-to-addressprinterattribute130EndEnumJobsAPIfunction110EndEnumPrintersAPIfunction110EnumJobsAPIfunction110EnumPrintersAPIfunction110environmentvariablesforaopmig150,151environmentvariablesforpidu154environmentvariables,changes113ErrorNumberAPIfunction110ErrorStringAPIfunction110examplesofaopmigcommand149exits,changes113extendedroutingcriteria,description94Ffilesystems,changes122files,changes112filterenhancementsforPrintInterface79filter-optionsjobattribute128filters,changes122Formattingfield125FORMS,CLASS,DESTroutingcriteria,description94forms,specifyingtoaopmig145FSSDATAparameter,description92FSSDATAparameter,new126FSSDATA=printer127Ggeneralprinterdefinitions,changingtypeof156generaluserconsiderations3GetJobInfoAPIfunction110GetPrinterInfoAPIfunction110GraphicEscapeexit114IiconvenhancementinIPPrintWay,description96InfoprintColor130Plusprinter,requirements40InfoprintColor130Plusprinter,supportfor40InfoprintMonitorforWindowsenhancements37,78InfoprintPortMonitorforWindowsenhancements37,78InfoprintPortMonitor,changes124InfoprintServerPrinterInventory112infoprint.
oms138information,summaryofchanges12InitAPIAPIfunction110input-trayjobattribute128input-tray-numberattribute128input-tray-numberjobattribute129instructionstoprinter,IPPrintWayenhancement98interfaceconsiderations3interfaces,summaryofchanges109InternetPrintingProtocol(IPP)clientinIPPrintWay,description90InternetPrintingProtocol(IPP)serverinPrintInterface,description70IPaddress,specifying156IPPrintWayaopmigexample150codepageconversion,description96coordinationwithNetSpool,description99coordinationwithPrintInterface,description99copysupport,description17e-mailsupport,description18,23exitenhancements,description22extendedroutingcriteria,description94FSSDATAparameter,description92IPPclient,description90migratingmultipledatasets147migratingoptionsdataset146printerinstructionenhancement,description98restrictportsenhancement,description101190z/OSV1R2.
0InfoprintServerMigrationIPPrintWay(continued)resubmitforfilteringenhancements26startupenhancements,description88suppressingmergingofroutingcriteria146TCP/IPconnectionenhancement29transformfunction102VTAMprintersupport,description104IPPrintWayBeginDataSetexit116IPPrintWayBeginDataSetexit,description22IPPrintWaycopysupport,description17IPPrintWaye-mailsupport,description18IPPrintWayEndDataSetexit119IPPrintWayEndDataSetexit,description22IPPrintWayexits,changes113IPPrintWayISPFpanels125IPPrintWayMessageexit121IPPrintWayMessageLogdataset112IPPrintWayOptionsdataset112IPPrintWayqueryprinterstatussupport,description25IPPrintWayRecordexit118IPPrintWayResponseNotificationexit121IPPrintWayRoutingdataset112IPPrintWayRoutingexit115IPPrintWaySMFexit120IPPrintWaystartupprocedure,changes133IPPrintWayTransmissionQueuedataset112IPPrintWayVTAMprinterenhancements,description23IPPrintWay,roadmapformigration11IPPclientinIPPrintWay,description90IPPserverinPrintInterface,description70IPPserverrequiresJava1.
339ISPFpanels,changes124ISPMALTstatement138ISPMLIBstatement137ISPPALTstatement138ISPPLIBstatement138JJava1.
3requiredbyIPPServer,description39JCLparametersontheDDstatement,changes126,127JCLparametersontheOUTPUTstatement,changes126JCLprocedures,changes135JCLroutingcriteriaforIPPrintWay,description94JESdefaultvalues,specifyingmultipletimes148JESNEWS127jobattributes,changed128jobstatusenhancements75KKanjiAFPPrintfeature65keyboard179LLinedensityfield125line-terminationprinterattribute130logonprocedure,changes137lpcommand139LPDcompatibilityfilter,description83lpd_compat.
so123lpstatcommand140LUNAMEADDcommand132LUNAMEPURGEcommand132Mmacros,changes134Maximumcopiesfield125maximum-copiesprinterattribute130mergingroutingcriteria,suppressinginaopmig146messages,changes129migrationoverview1roadmaps9strategy2summaryofrequiredtasks6terminology1migrationpaths,supported9migrationprogram141aopmigcommandexamples149AOPMIGRTsampleJCL151environmentvariablesforrunningfromTSO151inputdatasetsandfiles142introduction141reportsections159report,howtouse152rerunningafterrunningPIDU154running142runningfromTSO150runningPIDU153tablesofISPFfieldnamesandattributes169usingaopmigcommand144migrationreport160migrationtables169missingcomponents,creating156multipleinputdatasetstoaopmig147Nnames,changinginPrinterInventory155NetSpoolaopmigexample149BeginningofFileexitfor3270,description31BeginningofFileexitforSCS,description31coordinationwithIPPrintWay,description99dynamicallocationenhancements,description87GraphicEscapeexit,description31migratingend-of-filerulestable145migratingmultipledatasets147migratingOUTPUTJCLstatements145migratingpage-formattable144migratingprint-characteristicsdataset146migratingroutingdataset146Index191NetSpool(continued)operatorcommandenhancements,description85PCLconversion,description33TransparentDataControlexit,description31NetSpoolEnd-of-FileRulesTable112NetSpoolexits,changes113NetSpoolexits,description31NetSpooloperatorcommands,changes131NetSpoolPage-FormatTable112NetSpoolPCLconversion,description33NetSpoolPrintCharacteristicsdataset112NetSpoolstartupprocedure,changes133NetSpoolWTOR131netspool-formattingprinterattribute130NetSpool,roadmapformigration10NLSPATHenvironmentvariable113Ooperationalconsiderations3operatorcommands,changes131Optimizecopiesfield125optimize-copiesprinterattribute130optionsdataset,migrating146Orientationfield125OS/390Version2Release8enhancementsAFPtoPCL,AFPtoPDF,andAFPtoPostScripttransforms62InfoprintPortMonitorforWindowsenhancements78IPPrintWaycodepageconversion96IPPrintWayextendedroutingcriteria94IPPrintWayIPPclient90IPPrintWayprinterinstructionenhancements98IPPrintWayprinterselectionwithFSSDATAJCLparameter92IPPrintWayrestrictports101IPPrintWaystartupenhancements88IPPrintWayTransformFunction102IPPrintWayVTAMprintersupport104IPPrintWay,PrintInterface,andNetSpoolcoordination99KanjiAFPPrintfeature65NetSpooldynamicallocationenhancements87NetSpooloperatorcommandenhancements85PrintInterfaceAOPPRINTJCLprocedure72PrintInterfaceAPI80PrintInterfacedynamicallocationenhancements71PrintInterfaceIPPserver70PrintInterfacejobstatusenhancements75PrintInterfacelpcommandenhancements73PrintInterfaceLPDcompatibilityfilter83PrintInterfaceSAPOMS81PrintInterfaceSMBprotocolsupport76PrinterInterfacefilterenhancement79PrinterInventory53PSFforOS/390startupenhancements108remotetransforms68SNMPsubagent106Transformenhancements66transforms60OUTPUTJCLstatement,changes126OUTPUTJCLstatements,migrating145output-binjobattribute129output-bin-numberattribute128output-bin-numberjobattribute129overview,migration1Ppaths,migration9PCLconversioninNetSpool,description33pcl-line-densityprinterattribute130pcl-orientationprinterattribute130pcl-print-densityprinterattribute130pcl2afpcommand140pcl2afp.
dll123PIDU153rerunning154runningfromTSO154runningusingpiducommand153sampleJCLforrunning154piducommand140PIDUprinterattributes,changed130planningformigration2portmonitor,changes124PORTNO127ports,restrictionofrange101presentation-object-container-extraction-modeattribute40Printdensityfield125PrintInterfaceAOPPRINTprocedure,description72API,description80coordinationwithNetSpool,description99copysupport,description36dynamicallocation,description71filterenhancements79InfoprintPortMonitorforWindows,description37,78IPPserverJavasupport,description39IPPserver,description70jobstatusenhancements,description75lpcommand,description73LPDcompatibilityfilter,description83migratingprinterinventory145remotetransforms,description68SAPOMS,description81SMBprotocolsupport,description76PrintInterface>255copiessupport,description36PrintInterfaceISPFpanels125PrintInterfacesubsystem,description42PrintInterfacesupportforIBMInfoprintColor130Plusprinter,description40PrintInterface,roadmapformigration9print-characteristicsdataset,migrating146printerattributes,changed130printerdefinitionISPFpanels125printerinstructionenhancement,description98PrinterInventorycreating,withmigrationprogram141description53192z/OSV1R2.
0InfoprintServerMigrationPrinterInventory(continued)directoryname153editing155PrinterInventoryDefinitionUtility(PIDU)153rerunning154runningfromTSO154runningusingpiducommand153sampleJCLforrunning154printerinventory,PrintInterface,migrating145Printerlogmodefield125PrinterLUnamefield125PrintWayaopmigexample150codepageconversion,description96coordinationwithNetSpool,description99coordinationwithPrintInterface,description99copysupport,description17e-mailsupport,description18,23exitenhancements,description22extendedroutingcriteria,description94FSSDATAparameter,description92IPPclient,description90migratingmultipledatasets147migratingoptionsdataset146printerinstructionenhancement,description98restrictportsenhancement,description101resubmitforfilteringenhancements26startupenhancements,description88suppressingmergingofroutingcriteria146TCP/IPconnectionenhancement29transformfunction102VTAMprintersupport,description104printway-formattingprinterattribute130processingconsiderations2protocolprinterattribute130PRTOPTNS127PRTQUEUE127ps2afpcommand140ps2afp.
dll123PSFforOS/390FSAdefinitionenhancements,description45PSFforOS/390startupenhancements,description108PSPbucketxvipublications,related185publications,summaryofchanges12QqueryprinterstatussupportinIPPrintWay,description25RREFRESHcommand132releaseoverview13,51ReleaseTransformAPIfunction110RELOADcommand132remotetransformsupportforInfoprintColor130Plusprinter40remotetransforms,description68report,migration160RequestTransformAPIfunction110rerunningmigrationandPIDU154resource-libraryjobattribute129restrictports101resubmitforfilteringenhancements26Resubmitforfilteringfield125resubmitforfilteringfunction102resubmitforfiltering,relationshiptoPrintInterfacesubsystem42retained-fontsprinterattribute130retained-form-definitionsprinterattribute131retained-object-containersprinterattribute131retained-page-definitionsprinterattribute131retained-page-segmentsprinterattribute131roadmaps,migration9routingcriteria,description94routingcriteria,suppressingmergingofinaopmig146routingdataset,migrating146RRLVvalues45SS2FLAGSfield113samplecustomizationfiles,description47samples,changes135SAPOutputManagementSystem,description81sap2afpcommand140sap2afp.
dll123save-printer-informationprinterattribute131SCSautomaticpageorientationfield125scs-automatic-page-orientationprinterattribute131securityenhancements,description48ServerMessageBlock(SMB)protocolsupport76SetTerminationHandlerAPIfunction110shellscript,creatingforaopmigcommand148shift-out-shiftjobattribute129shortcutkeys179smaple.
pidl139SMBprotocolsupport76SMFtype6record,changes132SMF6JBID132SMF6USID133SNMPsubagent,description106startupprocedures,changes133stderrfile,aopmig144stdoutfile,aopmig144strategy,migration2SUBSYS128SUBSYSparameter(JCL)42,128subsystem,PrintInterface42summaryofrequiredmigrationtasks6supportedmigrationpaths9suppressingthemergingofroutingcriteria146SYS1.
LINKLIBmembers,changes134SYS1.
MACLIB,changes134SYS1.
PROCLIBmembers,changes135SYS1.
SAMPLIBmembers,changes135SYSEXECstatement138sysout-dataset-namejobattribute129sysout-job-idjobattribute129Index193sysout-job-namejobattribute129Ttables,migration169taskconsiderations2TCP/IPconnectiontimeoutenhancement,description29TermAPIAPIfunction110Transformenhancements,description66transformsupportforInfoprintColor130Plusprinter40transforms,description60,62transforms,remote,description68TransparentDataexits113TSOlogonprocedure,changes137TSO,runningmigrationprogramfrom150TSO,runningPIDUfrom154typeofprinterdefinitions,changing156Uunattendedmode124UNIXcommands,changes139UNIXfilter123unusedcomponents,deleting156usagenotes,foraopmigcommand148UserInitconfigurationFile112VviewingthePrinterInventory155VTAMprintersupportinIPPrintWay,description104VTAMprinters,enhancementsforinIPPrintWay,description23vtam-send-as-transparentprinterattribute131WWritePrintFileAPIfunction110Zz/OSV2R1,migratingtofromInfoprintServer4z/OSVersion1Release2enhancementsAFPDriver,AFPViewer14AOPSTARTandAOPSTOPprocedures15InfoprintPortMonitorforWindowsenhancements37IPPrintWaycopysupport17IPPrintWaye-mailsupport18IPPrintWayexitenhancements22IPPrintWayqueryprinterstatussupport25IPPrintWayresubmitforfilteringenhancements26IPPrintWayTCP/IPconnectiontimeout29IPPrintWayVTAMprinterenhancements23IPPServerJavarequirements39NetSpoolexits31NetSpoolPCLConversion33PrintInterface>255copiessupport36z/OSVersion1Release2enhancements(continued)PrintInterfacesubsystemforbatchapplications42PrintInterfacesupportforIBMInfoprintColor130Plusprinter40PSFforOS/390FSAdefinitionenhancements45samplecustomizationfiles47security48194z/OSV1R2.
0InfoprintServerMigrationReaders'Comments—We'dLiketoHearfromYouz/OSInfoprintServerMigrationPublicationNo.
G544-5743-03Overall,howsatisfiedareyouwiththeinformationinthisbookVerySatisfiedSatisfiedNeutralDissatisfiedVeryDissatisfiedOverallsatisfactionhhhhhHowsatisfiedareyouthattheinformationinthisbookis:VerySatisfiedSatisfiedNeutralDissatisfiedVeryDissatisfiedAccuratehhhhhCompletehhhhhEasytofindhhhhhEasytounderstandhhhhhWellorganizedhhhhhApplicabletoyourtaskshhhhhPleasetellushowwecanimprovethisbook:Thankyouforyourresponses.
MaywecontactyouhYeshNoWhenyousendcommentstoIBM,yougrantIBManonexclusiverighttouseordistributeyourcommentsinanywayitbelievesappropriatewithoutincurringanyobligationtoyou.
NameAddressCompanyorOrganizationPhoneNo.
Readers'Comments—We'dLiketoHearfromYouG544-5743-03G544-5743-03CutorFoldAlongLineCutorFoldAlongLineFoldandTapePleasedonotstapleFoldandTapeFoldandTapePleasedonotstapleFoldandTapeNOPOSTAGENECESSARYIFMAILEDINTHEUNITEDSTATESBUSINESSREPLYMAILFIRST-CLASSMAILPERMITNO.
40ARMONK,NEWYORKPOSTAGEWILLBEPAIDBYADDRESSEEIBMCorporationInformationDevelopmentIBMPrintingSystemsDivisionDepartmentH7FEBuilding004MBoulder,CO80301-9817___________________________________________________________________________________________________ProgramNumber:5694-A015697-F515655-G52G544-5743-03Spineinformation:z/OSInfoprintServerMigrationG544-5743-03