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

indicated as de$ayed .TN pac ets" 9ence, 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, 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, in seconds, o! t#e s$eep" -t timeout ud s#ou$d send re8uests in transaction mode" timeout is t#e time, in seconds, (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;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;e t#e (u!!er (e!ore reading eac# pac et )t#at is, 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;e is not $arge enoug#, t#e -S option can (e used to raise t#at $imit" (u!!ersi;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,-&'d.a'

flag is optiona$" +! flag is not speci!ied, 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, 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, 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"

+! fldname is t#e $itera$ va$ue SR2C#M, 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, t#e FBFR is reinitia$i;ed" FBFR reinitia$i;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, 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, !or e0amp$e, can (e entered in t#e input data as >>4<" ud recogni;es a$$ input in t#is !ormat, (ut its greatest use!u$ness is !or nonprinting c#aracters"

Processing Model
+nitia$$y, 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, ud waits !or a rep$y !ie$ded (u!!er" /!ter o(taining t#e rep$y, ud reads anot#er !ie$ded (u!!er !rom t#e standard input" +n so doing, 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, 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, to reinitia$i;e its FBFR structure* eit#er (y speci!ying t#e -un option on t#e command $ine, 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, it re8uires an app$ication password to access t#e app$ication" +! standard input is a termina$, ud prompts t#e user !or t#e password wit# ec#o turned o!! on t#e rep$y" 9owever, since ud accepts (u$ input on standard input, standard input wi$$ typica$$y (e a !i$e and not a termina$" +n t#is case, 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, t#en ud wi$$ !ai$" +! t#e security $eve$ is US6R4AU78, AC!, or MA#9A7"R:4AC!, and ud is run !rom a script, t#e environment varia($e 73;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

F!97B!9;R and F;6!97B!S must (e set and e0ported" F!97B!9;R must inc$ude <7U 9;R=udatao,j in t#e $ist o! directories" F;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;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, 5S962;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, 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, missing service names, errors in starting or committing a transaction, and timeouts, 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!;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!;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 <

+n t#is e0amp$e, ud !irst sends a !ie$ded (u!!er to t#e service BU: wit# C!;6#7 !ie$d set to @A @ones, A99R !ie$d set to 2B 2a''e> Road, S7"CC !ie$d to AAA, and S8AR6S !ie$d set to BDD" 6#en t#e !ie$ded (u!!er is returned !rom t#e BU: service, ud uses t#e ne0t set o! $ines to c#ange SR2C#M to S6!!, S7"CC to , and S8AR6S to 3DD" /$so, 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, 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:, C!;6#7 o! va$ue 7A S*itF, and so on"

Diagnostics
ud !ai$s i! it cannot (ecome a c$ient process, i! it cannot create t#e needed FBFRs, 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, errors in starting or committing a transaction, and timeouts, 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(), ?o*pi'ation
?@ Application Programming Guide FML Guide