ud, ud32, wud, wud32 Name

ud, wud - NonStop TUXEDO System/T driver program

Synopsis
ud [-p] [-d delay] [-e error_limit] [-r] [-s sleeptime] [-t timeout] [-n] [-u {n | u | j}] [-U usrname] [-C cltname] [-S buffersize] ud32 [options] wud [options] wud32 [options]

Description
ud reads an input pac et !rom its standard input using Fextread()" T#e pac et must
contain a !ie$d identi!ied as t#e name o! a service" T#e input pac et is trans!erred to an %&' !ie$ded (u!!er )FBFR* and sent to t#e service" +! t#e service t#at receives t#e FBFR is one t#at adds records to a data(ase, ud provides a met#od !or entering (u$ !ie$ded data into a data(ase nown to NonStop TUXEDO System/T" ,y using !$ags )see +N-UT %O.&/T* to (egin t#e $ines o! t#e input pac et, you can use test NonStop TUXEDO System/T services"

ud to

,y de!au$t, a!ter sending t#e FBFR to t#e service, ud e0pects a return FBFR" T#e sent and returned FBFRs are printed to ud1s standard output2 error messages are printed to standard error"

ud32 uses %&'34 (u!!ers o! type FBFR32" wud and wud32 are versions o! ud and ud32 (ui$t using t#e wor station $i(raries" On sites supporting 5ust /6S, on$y t#e wud and wud32 commands wi$$ (e present"

Options
ud supports t#e !o$$owing options7 -p
suppress printing o! t#e sent and returned !ie$ded (u!!ers"

-d
e0pect a de$ayed rep$y !or every re8uest" delay speci!ies t#e ma0imum de$ay time in seconds (e!ore timeout" +! timeout occurs, an error message is printed on stderr" +! ud receives rep$y messages !or previous re8uests wit#in t#e de$ay time, t#ey wi$$ (e

e t#e (u!!er (e!ore reading eac# pac et )t#at is. t#e de!au$t is 4:" -r ud s#ou$d not e0pect a rep$y message !rom servers" -s sleeptime s$eep (etween sends o! input (u!!ers" sleeptime is t#e time.a' flag is optiona$" +! flag is not speci!ied.indicated as de$ayed .-&'d. a new occurrence o! t#e !ie$d named (y fldname wit# va$ue fldval is added to t#e !ie$ded (u!!er" +! flag is speci!ied. fldval speci!ies t#e name o! a !ie$d w#ose va$ue s#ou$d (e assigned to t#e !ie$d named (y fldname" 1 t#e $ine is treated as a comment and is ignored" . in seconds. it is possi($e to receive more t#an one rep$y pac et wit#in a de$ay time interva$" -eerror_limit ud stops processing re8uests w#en errors e0ceed t#e $imit speci!ied in error_limit" +! no $imit is speci!ied. (e!ore t#e transaction is timed out" T#e -d delay and -r )no rep$y* options are not a$$owed in com(ination wit# t#e -t option" -u {n | u | j} speci!y #ow t#e re8uest (u!!er is modi!ied (e!ore reading eac# new pac et" T#e n option indicates t#at t#e (u!!er s#ou$d (e reinitia$i.e is not $arge enoug#. o! t#e s$eep" -t timeout ud s#ou$d send re8uests in transaction mode" timeout is t#e time.ed )treated as new*" T#e u option indicates t#at t#e (u!!er s#ou$d (e updated wit# t#e rep$y (u!!er using Fupdate()" T#e j option indicates t#at t#e rep$y (u!!er s#ou$d (e 5oined wit# t#e re8uest (u!!er using Fojoin()" -n re-initia$i. treat eac# (u!!er as a new (u!!er*" T#is option is e8uiva$ent to -un and is maintained !or compati(i$ity" -U usrname Use usrname as t#e user name w#en 5oining t#e app$ication" -C cltname Use cltname as t#e c$ient name w#en 5oining t#e app$ication" -S buffername +! t#e de!au$t (u!!er si. in seconds.TN pac ets" 9ence. t#e -S option can (e used to raise t#at $imit" (u!!ersi. it s#ou$d (e one o!7 / occurrence < o! fldname in FBFR s#ou$d (e c#anged to fldval" occurrence < o! fldname s#ou$d (e de$eted !rom FBFR" T#e ta( c#aracter is re8uired2 fldval is ignored" 0 t#e va$ue in fldname s#ou$d (e c#anged" +n t#is case.e can (e any num(er up to MA !"#$" T#e -d delay and -r options are mutua$$y e0c$usive" Input Format +nput pac ets consist o! $ines !ormatted as !o$$ows7 %&'a()&'dna*e+ta.

ud prompts t#e user !or t#e password wit# ec#o turned o!! on t#e rep$y" 9owever. ud reads anot#er !ie$ded (u!!er !rom t#e standard input" +n so doing. ud waits !or a rep$y !ie$ded (u!!er" /!ter o(taining t#e rep$y. standard input wi$$ typica$$y (e a !i$e and not a termina$" +n t#is case. !or e0amp$e. t#en ud wi$$ !ai$" +! t#e security $eve$ is US6R4AU78. t#e FBFR is reinitia$i. fldval is t#e name o! t#e service to w#ic# passed" FBFR is to (e 'engt#y !ie$d va$ues can (e continued on t#e ne0t $ine (y #aving t#e continuation $ine (egin wit# a ta(" / $ine consisting on$y o! t#e new$ine c#aracter ends t#e input and sends t#e pac et to ud" +! an input pac et (egins wit# a $ine consisting o! t#e c#aracter n !o$$owed (y t#e new$ine c#aracter. since ud accepts (u$ input on standard input. or MA#9A7"R:4AC!. it re8uires an app$ication password to access t#e app$ication" +! standard input is a termina$.e its FBFR structure* eit#er (y speci!ying t#e -un option on t#e command $ine. ud retains t#e returned (u!!er as t#e current (u!!er" T#is means t#at t#e $ines on t#e standard input t#at !orm t#e second !ie$ded (u!!er are ta en to (e additions to t#e (u!!er 5ust returned" T#at is. to reinitia$i.+! fldname is t#e $itera$ va$ue SR2C#M.9A7A must (e set to t#e user1s password" Portability T#ese commands are supported as NonStop TUXEDO System/T-supp$ied c$ients in t#e OSS environment" En ironment !ariables . or (y inc$uding a $ine w#ose on$y c#aracter is t#e $etter n as t#e !irst $ine o! an input set" ud may (e instructed to merge t#e contents o! t#e rep$y (u!!er into t#e re8uest (u!!er (y speci!ying eit#er t#e -uu option )Fupdate is used* or t#e -uj option )Fojoin is used*" Security +! ud is run in a security app$ication.es a$$ input in t#is !ormat. t#e environment varia($e 73. can (e entered in t#e input data as >>4<" ud recogni. t#e de!au$t action is !or ud to maintain a current (u!!er w#ose contents are added to (y a set o! input $ines" T#e set is de$imited (y a ($an $ine" ud may (e instructed to discard t#e current (u!!er )t#at is. and ud is run !rom a script. AC!. use t#e escaping convention !o$$owed (y t#e #e0adecima$ representation o! t#e desired c#aracter )see /S=++):**" /n additiona$ (ac s$as# is needed to protect t#e escape !rom t#e s#e$$" / space.ed" FBFR reinitia$i. ud reads a !ie$ded (u!!er !rom its standard input and sends it to t#e service w#ose name is given (y t#e fldval o! t#e $ine w#ere fldname e8ua$s SR2C#M" Un$ess t#e -r option is se$ected.ation can (e speci!ied !or a$$ pac ets wit# t#e -un option on t#e command $ine" To enter an unprinta($e c#aracter in t#e input pac et. t#e password is retrieved !rom t#e environment varia($e A33435" +! t#is environment varia($e is not speci!ied and an app$ication password is re8uired. (ut its greatest use!u$ness is !or nonprinting c#aracters" Processing Model +nitia$$y.

or i! it encounters an error in t#e OSS environment" +t a$so !ai$s i! it encounters more t#an 4: errors in processing a stream o! input pac ets" T#ese can (e synta0 errors. and timeouts. 5S962. errors in starting or committing a transaction. and errors in sending t#e input FBFR or in receiving t#e rep$y FBFR" Notes T#e !ina$ !ie$ded (u!!er in t#e input stream s#ou$d (e terminated (y a ($an $ine" E"amples < ud +6"FSR2C#M BU: C!. missing service names.F!97B!9.j in t#e $ist o! directories" F.6#7 7A S*itF A99R B Main Street S7"CC BBB S8AR6S BGE +CR/SR2C#M S6!! /S7"CC HHH /S8AR6S BDD +CR6"F < .C6 and optiona$$y 5S7:36 must (e set i! access is !rom a wor station" See ?o*pi'ation !or more detai$s on setting environment varia($es !or c$ient processes" Diagnostics ud !ai$s i! it cannot (ecome a c$ient process. i! it cannot create t#e needed FBFRs.6!97B!S must (e set and e0ported" F!97B!9.R and F.9A7A must (e set to t#e app$ication-speci!ic data necessary to 5oin t#e app$ication in a security app$ication wit# an aut#entication server i! standard input is not !rom a termina$" 5S#A99R.R=udatao.R must inc$ude <7U 9.6!97B!S must inc$ude Us>s&'ds as one o! t#e !ie$d ta($es" A33435 must (e set to t#e app$ication password in a security app$ication i! standard input is not !rom a termina$" 73.6#7 @A @ones A99R 2B 2a''e> Road S7"CC AAA S8AR6S BDD +CR/SR2C#M S6!! /S7"CC /S8AR6S 3DD S7"CC ::: S8AR6S BED +CRn SR2C#M BU: C!.

and timeouts. C!. errors in starting or committing a transaction. and errors in sending t#e input FBFR or in receiving t#e rep$y FBFR" Notes T#e !ina$ !ie$ded (u!!er in t#e input stream s#ou$d (e terminated (y a ($an $ine" See #lso Fextread(). A99R !ie$d set to 2B 2a''e> Road. or i! it encounters a system error" +t a$so !ai$s i! it encounters more t#an 4: errors in processing a stream o! input pac ets" T#ese can (e synta0 errors. missing service names. it creates an additiona$ occurrence o! t#e S7"CC !ie$d wit# va$ue ::: and an additiona$ occurrence o! t#e S8AR6S !ie$d wit# va$ue BED" T#is !ie$ded (u!!er is t#en sent to t#e S6!! service )t#e new va$ue o! t#e SR2C#M !ie$d*" 6#en S6!! sends (ac a rep$y !ie$ded (u!!er.6#7 !ie$d set to @A @ones. and so on" Diagnostics ud !ai$s i! it cannot (ecome a c$ient process. ud !irst sends a !ie$ded (u!!er to t#e service BU: wit# C!. ud discards it (y (eginning t#e ne0t set o! $ines wit# a $ine containing on$y t#e c#aracter n" ud t#en (egins (ui$ding an entire$y new input pac et wit# a SR2C#M o! BU:. i! it cannot create t#e needed FBFRs. and S8AR6S to 3DD" /$so.+n t#is e0amp$e. S7"CC to . S7"CC !ie$d to AAA.6#7 o! va$ue 7A S*itF. ud uses t#e ne0t set o! $ines to c#ange SR2C#M to S6!!. and S8AR6S !ie$d set to BDD" 6#en t#e !ie$ded (u!!er is returned !rom t#e BU: service. ?o*pi'ation ?@ Application Programming Guide FML Guide .