| From: CRONIC::COLBATH "STARS Mail Facility 04-Feb-1997 1338 -0500" 4-FEB-1997 13:38:15.09
To: scoman::standing
CC:
Subj: Here is why it does work on SCOMAN, FABSIX.
Mike,
Here is why it doesn't work on SCOMAN and FABSIX. You may want to send
this to the maintainer of the procedure. He will have to make some changes
for VMS 6.1.
art
[OpenVMS] F$GETQUI("DISPLAY_JOB",...,,"THIS_JOB") Returns Error Or Null
COPYRIGHT (c) 1988, 1993 by Digital Equipment Corporation.
ALL RIGHTS RESERVED. No distribution except as provided under contract.
Copyright (c) Digital Equipment Corporation 1992, 1997. All rights reserved.
PRODUCT: OpenVMS VAX, Versions 5.0 through 6.2
OpenVMS Alpha, Versions 1.5H1 through 6.2
COMPONENT: DCL
SOURCE: Digital Equipment Corporation
SYMPTOM:
A batch process spawns a subprocess using the command SPAWN @B.COM.
The B.COM command procedure contains the following line:
$ JOBNAME = F$GETQUI( "DISPLAY_JOB", "JOB_NAME", , "THIS_JOB" )
When this command executes, the symbol JOBNAME is set to a null, or
empty, string ("") and not the name of the batch job. In this
situation, any item code for the DISPLAY_JOB function returns a null
string.
When the parent process executes the above command, symbol JOBNAME is
correctly set to the batch job name. Expected values are returned for
other DISPLAY_JOB item codes as well.
Beginning with OpenVMS VAX V6.0, and OpenVMS Alpha, V6.1, the same
command, executed in a subprocess spawned from a batch job, or an
interactive process, returns this error:
%JBC-E-JOBQUEDIS, system job queue manager is not running
DIGITAL RESPONSE:
The problem of F$GETQUI returning an inappropriate error message is
corrected in OpenVMS Alpha V6.2 and OpenVMS VAX V6.2.
The return of the "NULL" value is the expected behavior of F$GETQUI
when executed from a spawned process.
\
\
\ ENGINEERING RESPONSE:
\
\ The JOBQUEDIS error returned form F$GETQUI is inappropriate. The
\ problem occurs due to code added in BLADE to support multiple queue
\ managers. Since the problem severity is low, I cannot guarantee this
\ will be addressed in the short term.
\
\ Dave
\
\
\ NOTE FROM THE CSC:
\
\ Engineering has fixed the bad error message in a future (6.2)
\ version of OpenVMS. However, the invalid "null" return has
\ not been addressed, and has been re-elevated under C950305-580.
\
\
\ ENGINEERING RESPONSE TO C950305-580:
\
\ 05-May-1995
\
\ The original problem was not closed in error. This behaviour has
\ existed since V5.5 and will not be changed.
WORKAROUND 1:
Avoid using the F$GETQUI command from a spawned procedure. SUBMIT or
execute (using the "@") the procedure instead of using the SPAWN
command.
WORKAROUND 2:
To receive information from a procedure that is called with the SPAWN
command from a batch job, use the following commands in the spawned
procedure:
$ ENTRYNO=F$GETQUI("DISPLAY_ENTRY","ENTRY_NUMBER",ENTRYNO,)
$ SHOW SYMBOL ENTRYNO
$ JOBNAME=F$GETQUI("DISPLAY_ENTRY","JOB_NAME",ENTRYNO)
$ LOGFILE=F$GETQUI("DISPLAY_ENTRY","LOG_SPECIFICATION",ENTRYNO)
$ NO_LOG =F$GETQUI("DISPLAY_ENTRY","JOB_LOG_NULL",ENTRYNO)
$ SHOW SYMBOL JOBNAME
$ SHOW SYMBOL LOGFILE
$ SHOW SYMBOL NO_LOG
WORKAROUND 3:
A VAXQMAN or ALPQMAN ECO kit may address the problem of the inappropriate
error described in this article. Refer to the ECO-SUMMARY article to
determine if this ECO corrects the problem for your specific
configuration. The ECO-SUMMARY information may be found using a query
of VAXQMAN or ALPQMAN.
\
\ Note: TIMA users should access the TIMATOOLS ECO_MUP_CERT database
\ to view the ECO-SUMMARY information.
ANALYSIS:
The documentation for the flag "THIS_JOB", implies that it may only be
used when F$GETQUI is executed from a batch job. The description of
THIS_JOB in the "OpenVMS Dictionary: A-M", March 1994, (AA-PV5KB-TK),
page DCL1-341 states:
Selects all job file information about the calling batch job,
the command file being executed, or the queue associated with
the calling batch job.
Since the subprocess spawned by the batch process is part of the
same job family, it might be assumed that executing the F$GETQUI
lexical function from the subprocess would also return information
about the batch process. However, this is not the current behavior.
\
\
\ RETEST INFORMATION:
\
\ The following command procedures demonstrate the behavior:
\
\ ----- A.COM --------------------------------------------------------
\ $ on error then continue
\ $ show process
\ $ jobname=f$getqui("display_job","job_name",,"this_job")
\ $ logfile=f$getqui("display_job","log_specification",,"this_job")
\ $ no_log =f$getqui("display_job","job_log_null",,"this_job")
\ $ show symb jobname
\ $ show symb logfile
\ $ show symb no_log
\ $ show time
\ $ spawn @b.com
\ $ exit
\
\ ----- B.COM --------------------------------------------------------
\ $ on error then continue
\ $ jobname=f$getqui("display_job","job_name",,"this_job")
\ $ on error then continue
\ $ logfile=f$getqui("display_job","log_specification",,"this_job")
\ $ on error then continue
\ $ no_log =f$getqui("display_job","job_log_null",,"this_job")
\ $ on error then continue
\ $ show symb jobname
\ $ on error then continue
\ $ show symb logfile
\ $ on error then continue
\ $ show symb no_log
\ $ on error then continue
\ $ show process
\ $ show time
\ $ exit
\
\
\ REFERENCES:
\
\ Escalations reported on this problem:
\
\ QARs: SPR_VMS_V5 #02011, CORAL-FT #01376, V6 #00304
\ Case-Ids: ICA-42561
\ Field Service Log #: HPXQ32BA2, CXOQ91228, ICAX42561
\ IPMT Case_Ids: CFS.25181, CFS.12741
\ CHAMP/CSC Service Request (SRQ) #: C950305-580, C920904-328,
\ C940722-114
\
\
\ CONTRIBUTORS:
\
\ Technical:
\ Peggy Annin (140028)
\ Robert Bowman (120517)
\ Michael Banovsky (069805)
\ John Hockett (140060)
\
\ Editorial:
\ Michael Banovsky (069805)
\ Judy Borders (173803)
\ Peggy Annin (140028)
\ Barbara Haas (312827)
\ Marilynn Farrington (120735)
\
\\ SOURCE=CHAMP_TO_IPMT DCL LEX BATCH VMS ALPHA DUP
\\ PROD=OPENVMS-VAX SPD=25.01 OS=OPENVMS-VAX GRP=OPENVMS-VAX CAT=OPSYS
\\ PROD=OPENVMS-AXP SPD=41.87 OS=OPENVMS-AXP GRP=OPENVMS-AXP CAT=OPSYS
\\ 140028 120517 069805 140060
\\ HPXQ32BA2 SRC950305000580 SRC940722000114
\\ SPR_ICA-42561 SRC920904000328 ICAX42561 CSCBUG_DCL-0153
\\ EDIT_SRQ=C940722-114 EDIT_SRQ=C941019-2834 EDIT_SRQ=C941024-5616
\\ EDIT_SRQ=C950207-6859 EDIT_SRQ=C950207-7128 EDIT_SRQ=C950217-2357
\\ EDIT_SRQ=C950217-2603 EDIT_SRQ=C950508-9357 EDIT_SRQ=C950613-4452
\\ EDIT_SRQ=C951103-2501 EDIT_SRQ=C970108-4293
\\ CSCPAT ALPQMAN VAXQMAN
\\ FIXEDSSB RESPONSE=NOBUG QREVIEW=199612
\\ TYPE=KNOWN_PROBLEM TYPE=ESCALATION
|